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INTRODUCTION 

This manual is intended to supplement the information contained in the UniPlus^ 
User's Manual and to provide an easy reference volume for those who must admin- 
ister the UniPlus"^ system. Accordingly, only those commands and descriptions 
deemed appropriate for system administrators have been included here. 

This manual is divided into three sections; 

1. System Maintenance Commands and Application Programs 

7. Special Files 

8. System Maintenance Procedures 

Throughout this volume, each reference of the form warned M), nameO), or 
nameiS), refers to entries in this manual, while all other references to entries of 
the form «a/ne(N), where A'^ is a number possibly followed by a letter, refer to 
entry name in Section A'^ of the UniPlus'^ User's Manual. 

Section 1 {System Maintenance Commands and Application Programs) contains sys- 
tem maintenance programs such as fsck, mkfs, etc., which generally reside in the 
directory /etc; these entries carry a subsection designation of "M" for cross 
referencing reasons. 

Section 7 {Special Files) discusses the characteristics of each system file that actu- 
ally refers to an input/output device. The names in this section generally refer to 
device names for the hardware, rather than to the names of the special files them- 
selves. 

Section 8 {System Maintenance Procedures) discusses crash recovery and boot pro- 
cedures. 

Each section consists of a number of independent entries of a page or so each. The 
name of the entry appears in the upper corners of its pages. Entries within each 
section are alphabetized, with the exception of the introductory entry that precedes 
each section. The page numbers of each entry start at 1. The version date of the 
entry appears in the lower left corner of each page. Some entries may describe 
several routines, commands, etc. In such cases, the entry appears only once, alpha- 
betized under its "major" name. 

All entries are based on a common format, not all of whose parts always appear: 

The NAME part gives the name(s) of the entry and briefly states its purpose. 

The SYNOPSIS part summarizes the use of the program being described. A 
few conventions are used, particularly in Section 1 {Commands): 

Boldface strings are literals and are to be typed just as they appear. 

Italic strings usually represent substitutable argument prototypes and 
program names found elsewhere in the manual. 

Square brackets I) around an argument prototype indicate that the 
argument is optional. When an argument prototype is given as "name" 
or "file", it always refers to a .file name. 

Ellipses ... are used to show that the previous argument prototype 
may be repeated. 
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A final convention is used by the commands themselves. An argu- 
ment beginning with a minus -, plus +, or equal sign = is often taken 
to be some sort of flag argument, even if it appears in a position where 
a file name could appear. Therefore, it is unwise to have files whose 
names begin with — , +, or =. 

The DESCRIPTION part discusses the subject at hand. 

The EXAMPLE part gives example (s) of usage, where appropriate. 

The FILES part gives the file names that are built into the program. 

The SEE ALSO part gives pointers to related information. 

The DIAGNOSTICS part discusses the diagnostic indications that may be pro- 
duced. Messages that are intended to be self-explanatory are not listed. 

The WARNINGS part points out potential pitfalls. 

The BUGS part gives known bugs and sometimes deficiencies. Occasionally, 
the suggested fix is also described. 

On most systems, all entries are available on-line via the manil) command, q.v. 

Permuted Index 

At the front of each volume there is a table of contents and a permuted index. 
The permuted index is a computer-generated index that uses the information in the 
NAME part of each entry in the User's and Administrator's Manuals. The per- 
muted index contains three columns. The center column is an alphabetic list of 
keywords as they appear in the NAME part of the entries. The last column is the 
entry that the keyword in the center column refers to. This entry is followed by 
the appropriate section number in parentheses. The first column contains the 
remaining information from the NAME part that either precedes or follows the key- 
word. 

For example, to look for a text editor, scan the center column for the word "edi- 
tor". There are several index lines containing an "editor" reference, i.e.: 

ed, red: text editor. ed(l) 

files. Id: link editor for common object ld(l) 

You can then turn to the entries listed in the last column, ed(l) and W(l), to find 
information on the editor. 
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TABLE OF CONTENTS 

1. System Maintenance Commands and Application Programs 

intro introduction to system maintenance commands and application programs 

accept allow/ prevent LP requests 

acct .... overview of accounting and miscellaneous accounting commands 

acctcms command summary from per-process accounting records 

acctcon connect-time accounting 

acctmerg merge or add total accounting files 

acctprc process accounting 

acctsh shell procedures for accounting 

badblk program to set or update bad block information 

bcopy interactive block copy 

brc . . system initialization shell scripts 

chroot . change root directory for a command 

clri clear i-node 

cron clock daemon 

dcopy copy file systems for optimal access time 

devnm device name 

df report number of free disk blocks 

diskfdrmat format a disk 

disktune tune floppy disk settling time parameters 

errdead extract error records from dump 

errdemon error-logging daemon 

errpt process a report of logged errors 

errstop terminate the error-logging daemon 

ff list file names and statistics for a file system 

filesave daily/weekly UNIX file system backup 

fine fast incremental backup 

free recover files from a backup tape 

fsck file system consistency check and interactive repair 

fsdb file system debugger 

fuser identify processes using a file or file structure 

fwtmp manipulate connect accounting records 

getty ........ ^ . set terminal type, modes, speed, and line discipline 

init process control initialization 

install install commands 

killall kill all active processes 

link exercise link and unlink system calls 

Ipadmin configure the LP spooling system 

Ipsched start/stop the LP request scheduler and move requests 

mkfs construct a file system 

mkfs512 construct a file system 

mklost+ found make a lost + found directory for fsck 

mknod build special file 

mount mount and dismount file system 

mvdir ; move a directory 

ncheck generate names from i-numbers 

profiler operating system profiler 

pstat print system facts 

pwck password/group file checkers 

runacct run daily accounting 

sar system activity report package 

setmnt establish mount table 

shutdown terminate all processing 

updater update files between two machines 
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uuclean uucp spool directory clean-up 

uusub monitor uucp networic 

vchk version checkup 

volcopy copy file systems with label checking 

wall write to all users 

whodo who is doing what 

7. Special Files 

intro introduction to special files 

aliases aliases file for delivermail 

err error-logging interface 

hosts host table for bnet 

mem core memory 

null the null file 

termio general terminal interface 

tty controlling terminal interface 

8. System Maintenance Procedures 

intro introduction to system maintenance procedures 

boot startup procedures 

crash what to do when the system crashes 

delivermail deliver mail to arbitrary people 

netmail the bnet network mail system 

netmailer deliver mail to bnet 
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/functions of HP 2640 and 

handle special functions of HP 

archiver. hpio: HP 

functions of DASI 300 and/ 

/special functions of DASI 

of DASI 300 and 300s/ 300, 

functions of DASI 300 and 

13tol, ltoI3: convert between 

comparison. diff3: 

Tektronix 4014 terminal. 

paginator for the Tektronix 

of the DASI 450 terminal. 

special functions of the DASI 

long integer and base-64/ 

value. 

abs: return integer 

/floor, ceiling, remainder, 

socket, accept: 

a socket. 

LP requests. 

utime: set file 

of a file, touch: update 

accessibility of a file. 

machine/ sputl, sgetl: 

phys: allow a process to 

sadp: disk 

copy file systems for optimal 

/setutent, endutent, utmpname: 

access: determine 

enable or disable process 

acctcon2: connect-time 

acctprcl, acctprc2: process 

turnacct: shell procedures for 

runacct: run daily 

/accton, acctwtmp: overview of 

accounting and miscellaneous 

acct: per-process 

search and print process 

acctmerg: merge or add total 

summary from per-process 

wtmpfix: manipulate connect 

process accounting. 

file format. 

per-process accounting/ 

process accounting file(s). 

connect-time accounting. 

accounting, acctconl, 

acctwtmp: overview of/ 

overview of/ acctdisk, 

accounting files. 

acctdisk, acctdusg, 

accounting. 

acctprcl, 

acctdisk, acctdusg, accton, 

sin, cos, tan, asin, 

killall: kill all 

current SCCS file editing 

report process data and system 

sag: system 

sal, sa2, sadc: system 



262 1 -series terminals hp.l 

2640 and 2621 -series/ hp: hp.l 

2645 A terminal tape file hpio.l 

300, 300s: handle special 300.1 

300 and 300s terminals 300.1 

300s: handle special functions .... 300.1 

300s terminals, /special 300.1 

3-byte integers and long/ 13tol.3c 

3-way differential file difF3.1 

4014: paginator for the 4014.1 

4014 terminal. 4014: 4014.1 

450: handle special functions .... 450.1 

450 terminal. 450: handle 450.1 

a641, 164a: convert between h641.3c 

abort: generate an lOT fault abort.3c 

abs: return integer absolute abs.3c 

absolute value abs.3c 

absolute value functions floor.3m 

accept a connection on a accept.2n 

accept: accept a connection on .... accept.2n 

accept, reject: allow/prevent accept. Im 

access and modification times utime.2 

access and modification times .... touch. 1 

access: determine access.2 

access long numeric data in a .... sputl.3x 

access physical addresses phys.2 

access profiler sadp.l 

access time, dcopy: dcopy.lm 

access utmp file entry getut.3c 

accessibility of a file access.2 

accounting, acct: acct.2 

accounting, acctconl, acctcon.lm 

accounting acctprcl m 

accounting, /startup, acctsh.lm 

accounting runacct. Im 

accounting and miscellaneous/ .... acct.lm 

accounting commands, /of acct.lm 

accounting file format acct.4 

accounting file(s). acctcom: acctcom.l 

accounting files acctmerg. Im 

accounting records, /command . . . acctcms.lm 

accounting records, fwtmp, fwtmp.lm 

acct: enable or disable acct.2 

acct: per-process accounting acct.4 

acctcms: command summary from . . acctcms.lm 

acctcom: search and print acctcom.l 

acctconl, acctcon2: acctcon.lm 

acctcon2: connect-time acctcon.lm 

acctdisk, acctdusg, accton, acct.lm 

acctdusg, accton, acctwtmp: acct.lm 

acctmerg: merge or add total .... acctmerg. Im 

accton, acctwtmp: overview of/ ... acct.lm 

acctprcl, acctprc2: process acctprcl m 

acctprc2: process accounting acctprcl m 

acctwtmp: overview of/ acct.lm 

acos, atan, atan2:/ trig.3m 

active processes killall. Im 

activity, sact: print sact.l 

activity, /time a command; timex.l 

activity graph sag.lg 

activity report package sar.lm 
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sar: system 
random, hopefully interesting, 
formatting/ mosd: the OSDD 

acctmerg: merge or 

up internet hosts by name or 

socket, socketaddr: return 

a process to access physical 

sees files. 

admin: create and 

game. 

alarm: set a process's 

clock. 

delivermail. 

aliases: 

earth, aliens: The 

attack the earth. 

change data segment space 

realloc, calloc: main memory 

physical addresses, phys: 

accept, reject: 

information for bad block/ 

for bad block/ altblk: 

sort: sort 

terminal, worms: 

rain: 

, bed: convert to 

editor output. 

introduction to commands and 

maintenance commands and 

maintainer. 

format. 

number: convert 

delivermail: deliver mail to 

language, be: 

cpio: format of cpio 

tp: manipulate tape 

maintainer. ar: 

ar: 

HP 264SA terminal tape file 

tar: tape file 

cpio: copy file 

command, xargs: construct 

getopt: get option letter from 

echo: echo 

expr: evaluate 

be: arbitrary-precision 

number facts. 

expr: evaluate arguments 

characters, asa: interpret 

control characters. 

ascii: map of 

/translates object files into 

set. 

long integer and base-64 

number, atof: convert 

and/ ctime, localtime, gmtime, 

trigonometric/ sin, cos, tan, 

help: 

as: 

output, a.out: 

assertion. 

assert: verify program 



activity reporter sar. 1 

adage, fortune: print a fortune.6 

adapter macro package for mosd.5 

adb: debugger adb.l 

add total accounting files acctmerg. Im 

address, rhost, raddr: look rhost.3n 

address associated with a socketaddr.2n 

addresses, phys: allow phys.2 

admin: create and administer .... admin.l 

administer SCCS files admin.l 

adventure: an exploration adventure.6 

alarm clock alarm.2 

alarm: set a process's alarm alarm.2 

aliases: aliases file for aliases.7n 

aliases file for delivermail aliases.7n 

alien invaders attack the aliens.6 

aliens: The alien invaders aliens.6 

allocation, brk, sbrk: brk.2 

allocator, malloc, free, malloc.3c 

allow a process to access phys.2 

allow/ prevent LP requests accept. Im 

altblk: alternate block altblk.4 

alternate block information altblk.4 

and/ or merge files sort.l 

animate worms on a display worms.6 

animated raindrops display rain.6 

antique media bcd.6 

a.out: assembler and link a.out.4 

application programs, intro: intro.l 

application programs, /system .... intro. Im 

ar: archive and library ar.l 

ar: archive (library) file ar.4 

Arabic numerals to English number.6 

arbitrary people delivermail.Sn 

arbitrary-precision arithmetic .... be. 1 

archive cpio.4 

archive tp.l 

archive and library ar. 1 

archive (library) file format ar.4 

archiver. hpio: hpio.l 

archiver tar.l 

archives in and out cpio.l 

argument list(s) and execute .... xargs. 1 

argument vector getopt.3c 

arguments echo.l 

arguments as an expression expr. 1 

arithmetic language bc.l 

arithmetic: provide drill in arithmetic.6 

as an expression expr.l 

as: assembler as.l 

ASA carriage control asa. 1 

asa: interpret ASA carriage asa. 1 

ASeil character set ascii.5 

ASeil formats suitable for/ hex.l 

ascii: map of ASeil character .... ascii.S 

ASeil string, /convert between . . . h641.3c 

ASeil string to floating-point .... atof.3c 

asctime, tzset: convert date ctime.3c 

asin, acos, atan, atan2: trig.3m 

ask for help. help.l 

assembler as.l 

assembler and link editor a.out.4 

assert: verify program assert.3x 

assertion assert.3x 
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setbuf: 

socketaddr: return address 

sin, cos, tan, asin, acos, 

cos, tan, asin, acos, atan, 

floating-point number. 

integer, strtol, atol, 

integer, strtol, 

aliens: The alien invaders 

autorobots: Escape from the 

automatic robots. 

wait: 

processing language. 

ungetc: push character 

back: the game of 

daily/weekly UNIX file system 

fine: fast incremental 

free: recover files from a 

block information for 

/program to set or update 

update bad block information. 

banner?: print large 

printer. 

terminal capability data 

port, ttytype: data 

between long integer and 

(visual) display editor 

portions of path names. 

arithmetic language. 

system initialization/ brc, 



cb: C program 

list contents of directory 

jO, jl, jn, yO, yl, yn: 

strings in an object, or other 

fread, fwrite: 

bsearch: 

tdelete, twalk: manage 

remove symbols and relocation 

/set or reset the teletype 

bj: the game of 

sync: update the super 

bcopy: interactive 

sum: print checksum and 

block information for bad 

program to set or update bad 

block/ altblk: alternate 

bit, bh512: 

df: report number of free disk 

sum?: sum and count 

data. 

bit, 

/etc/hosts: host table for 

netmail: the 

system initialization shell/ 

space allocation. 

modest-sized programs. 



assign buffering to a stream setbuf.Ss 

associated with a socket socketaddr .2n 

atan, atan2: trigonometric/ trig.3m 

atan2: trigonometric/ sin, trig.3m 

atof: convert ASCII string to .... atof.3c 

atoi: convert string to strtol.Sc 

atol, atoi: convert string to strtol.3c 

attack the earth aliens.6 

automatic robots autorobots.6 

autorobots: Escape from the autorobots.6 

await completion of process wait.l 

awk: pattern scanning and awk.l 

back into input stream ungetc.3s 

back: the game of backgammon. . . . back.6 

backgammon back.6 

backup, filesave, tapesave: filesave.lm 

backup finc.lm 

backup tape frec.lm 

bad block handling, /alternate .... altblk. 4 

bad block information badblk.lm 

badblk: program to set or badblk.lm 

banner: make posters banner. 1 

banner on printer banner?.! 

banner?: print large banner on ... . banner?.! 

base, termcap: termcap.5 

base of terminal types by ttytype.4 

base-64 ASCII string, /convert . . . h641.3c 

based on ex. /screen oriented . . . . vi.l 

basename, dirname: deliver basename.l 

be: arbitrary-precision bc.l 

bed: convert to antique media bcd.6 

bcheckrc, re, powerfail: brc.lm 

bcopy: interactive block copy bcopy. !ni 

bdiff: big diff bdiff.l 

beautifier cb.l 

(Berkeley version). Is?: Is?.l 

Bessel functions. bessel.3m 

bfs: big file scanner. bfs.l 

binary file, /the printable strings.! 

binary input/output fread.3s 

binary search bsearch.3c 

binary search trees, tsearch, tsearch.3c 

bits, strip: strip.! 

bits to a sensible state. ....... tset. 1 

bj: the game of black jack bj.6 

blackjack bj.6 

block sync! 

block copy bcopy.lm 

block count of a file sum.l 

block handling, /alternate altblk.4 

block information, badblk: badblk.lm 

block information for bad altb!k.4 

block transfer data blt.3 

blocks df.lm 

blocks in a file sum?.l 

bit, blt512: block transfer blt.3 

bits 12: block transfer data blt.3 

bnet hosts.?n 

bnet network mail system netmail.Sn 

boot: startup procedures boot.8 

brc, bcheckrc, re, powerfail: brc.lm 

brk, sbrk: change data segment . . . brk.2 

bs: a compiler/interpreter for . . . . bs.l 

bsearch: binary search bsearch. 3c 
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stdio: standard 

setbuf: assign 

mknod: 

swab: swap 

cc: 

cflow: generate 

cpp: the 

maintain a tags file for a 

cb: 

lint: a 

cxref: generate 

message file by massaging 

dc: desk 
cal: print 

data returned by stat system 

cu: 

malloc, free, realloc, 

link and unlink system 

intro: introduction to system 

to an LP line printer. Ip, 

termcap: terminal 

cribbage: the 

pnch: file format for 

asa: interpret ASA 

files. 



commentary of an SCCS delta. 

ceiling, remainder,/ floor, 

/ceil, fmod, fabs: floor, 

delta: make a delta 

pipe: create an interprocess 

stream, ungetc: push 

and neqn. eqnchar: special 

file, freq: report on 

user, cuserid: get 

/getchar, fgetc, getw: get 

/putchar, fputc, putw: put 

ascii: map of ASCII 

interpret ASA carriage control 

tolower, toascii: translate 

iscntrl, isascii: classify 

tr: translate 

given/ sumdir: sum and count 

lastlogin, monacct, nuUadm,/ 

killer robots. 

directory. 

/dfsck: file system consistency 

constant-width text for/ cw, 

text for nroff or/ eqn, neqn, 

lint: a C program 

grpck: password/ group file 

copy file systems with label 

systems processed by fsck. 

formatted with the/ mm, osdd, 

file, sum: print 

vchk: version 

chown, 

times: get process and 

terminate, wait: wait for 



buffered input/output package. . . . stdio.Ss 

buffering to a stream setbuf.3s 

build special file mknod. Im 

bytes swab.3c 

C compiler cc.l 

C flow graph cflow.l 

C language preprocessor cpp.l 

C program, ctags: ctags.l 

C program beautifier cb.l 

C program checker lint.l 

C program cross reference cxref. 1 

C source, /create an error mkstr.l 

cal: print calendar cal.l 

calculator del 

calendar cal.l 

calendar: reminder service calendar. 1 

call. Stat: stat.S 

call another UNIX System cu.lc 

calloc: main memory allocator malloc.3c 

calls, link, unlink: exercise iink.lm 

calls and error numbers intro.2 

cancel: send/ cancel requests Ip.I 

capability data base termcap.5 

card game cribbage cribbage.6 

card images pnch.4 

carriage control characters asa. 1 

cat: concatenate and print cat.l 

cb: C program beautifier cb.l 

cc: C compiler cc.l 

cd: change working directory. . . . . cd.l 

cdc: change the delta cdc.l 

ceil, fmod, fabs: floor, floor.3m 

ceiling, remainder, absolute/ .... floor.3m 

cflow: generate C flow graph cflow. 1 

(change) to an SCCS file delta. 1 

channel pipe.2 

character back into input ungetc.3s 

character definitions for eqn eqnchar. 5 

character frequencies in a freq.l 

character login name of the cuserid.3s 

character or word from stream. . . . getc.3s 
character or word on a stream. . . . putc.3s 

character set ascii.5 

characters, asa: asa.l 

characters. /_toupper, conv.3c 

characters, /isprint, isgraph, ctype.3c 

characters tr.l 

characters in the files in the sumdir. 1 

chargefee, ckpacct, dodisk, acctsh.lm 

chase: Try to escape the chase.6 

chdir: change working chdir.2 

check and interactive repair fsck.lm 

checkcw: prepare cw.l 

checkeq: format mathematical .... eqn.l 

checker lint.l 

checkers, pwck, pwck.lm 

checking, volcopy, labelit: volcopy.lm 

checklist: list of file checklist.4 

checkmm: print/check documents . . mm. I 
checksum and block count of a . . . sum.l 

checkup vchk.lm 

chgrp: change owner or group chown. 1 

child process times times.2 

child process to stop or wait. 2 



-4 



Permuted Index 



of a file, 
group. 

for a command. 

monacct, nulladm,/ chargefee, 

isgraph, iscntrl, isascii: 

uuclean: uucp spool directory 

clri: 

clear: 

status/ ferror, feof, 

(command interpreter) with 

alarm: set a process's alarm 

cron: 

close: 

descriptor. 

fclose, fflush: 



line-feeds. 

comb: 

common to two sorted files. 

change root directory for a 

system: issue a shell 

test: condition evaluation 

time: time a 

argument list(s) and execute 

nice: run a 

env: set environment for 

uux: unix to unix 

(sh/ nohup: run a 

C-like syntax, csh: a shell 

getopt: parse 

/shell, the standard/ restricted 

and system/ timex: time a 

per-process/ acctcms: 

and miscellaneous accounting 

install: install 

intro: introduction to 

/to system maintenance 

at: execute 

cdc: change the delta 

comm: select or reject lines 

socket: create an endpoint for 

ipcs: report inter-process 

stdipc: standard interprocess 

diff: differential file 

cmp: 

sees file, sccsdiff: 

diff 3: 3-way differential file 

dircmp: directory 

regcmp: regular expression 

expression, regcmp, regex: 

regexp: regular expression 

cc:C 

yacc: yet another 

modest-sized programs, bs: a 

erf, erfc: error function and 

wait: await 

pack, peat, unpack: 



chmod: change mode chmod.l 

chmod: change mode of file chmod.2 

chown: change owner and group . . . chown.2 

chown, chgrp: change owner or ... chown. 1 

chroot: chaitge root directory chroot.2 

chroot: change root directory .... chroot. Im 

ckpacct, dodisk, lastlogin, acctsh.lm 

classify characters, /isprint, ctype.Sc 

clean-up uuclean.lm 

clear: clear terminal screen. ..... clear. 1 

clear i-node ciri.lm 

clear terminal screen clear. 1 

clearerr, fileno: stream ferror.3s 

C-like syntax, csh: a shell csh.l 

clock alarm.2 

clock daemon cron.lm 

clock: report ePU time used clock.3c 

close a file descriptor close.2 

close: close a file close.2 

close or flush a stream . fclose.3s 

clri: clear i-node ciri.lm 

cmp: compare two files cmp.l 

col: filter reverse col.l 

comb: combine sees deltas comb.l 

combine SCCS deltas comb.l 

comm: select or reject lines comm.l 

command, chroot: chroot. Im 

command system.3s 

command test.l 

command time.l 

command, xargs: construct xargs.l 

command at low priority nice. 1 

command execution env.l 

command execution uux.lc 

command immune to hangups .... nohup. 1 

(command interpreter) with csh. 1 

command options getopt. 1 

command programming language. . . sh.l 

command; report process data .... timex. 1 

command summary from acctcms. Im 

commands, /of accounting acct.lm 

commands install. Im 

commands and application/ intro. 1 

commands and application/ intro. Im 

commands at a later time at.l 

commentary of an SCCS delta. . . . cdc.l 

common to two sorted files comm.l 

communication socket.2n 

communication facilities/ ipcs.l 

communication package stdipc.3c 

comparator. diff.l 

compare two files cmp.l 

compare two versions of an sccsdiff. 1 

comparison diff3.1 

comparison dircmp.l 

compile regcmp. 1 

compile and execute regular regcmp.3x 

compile and match routines regexp.5 

compiler cc.l 

compiler-compiler yacc.l 

compiler/ interpreter for bs.l 

complementary error function. .... erf.3m 

completion of process wait.l 

compress and expand files pack. 1 
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cat: 

test: 

uvar: returns system-specific 

system. Ipadmin: 

fwtmp, wtmpfix: manipulate 

on a socket. 

an out-going terminal line 

accept: accept a 

connect: initiate a 

acctconl, acctcon2: 

fsck, dfsck: file system 

cw, checkcw: prepare 

mkfslb: 

mkfs: 

execute command, xargs: 

nroif/troff, tbl, and eqn 

Is: list 

(Berkeley version). Is7: list 

csplit: 

fcntl: file 

uucp status inquiry and job 

vc: version 

asa: interpret ASA carriage 

ioctl: 

init, telinit: process 

msgctl: message 

semctl: semaphore 

shmctl: shared memory 

fcntl: file 

tcp: Internet Transmission 

interface, tty: 

terminals, term: 

units: 

dd: 

English, number: 

floating-point number, atof: 

integers and/ 13tol, ltol3: 

and base-64 ASCII/ a641, 164a: 

/gmtime, asctime, tzset: 

to string, ecvt, fcvt, gcvt: 

scanf, fscanf, sscanf: 

strtol, atol, atoi: 

bed: 

bcopy: interactive block 

rep: remote file 

uulog, uuname: unix to unix 

System-to-UNIX System file 

dd: convert and 

cpio: 

access time, dcopy: 

checking, volcopy, labelit: 

cp. In, mv: 

file. 

core: format of 

mem, kmem: 

atan2: trigonometric/ sin, 

functions, sinh, 

wc: word 

sum7: sum and 

in the given/ sumdir: sum and 

sum: print checksum and block 

files. 

cpio: format of 

and out. 



concatenate and print files cat. 1 

condition evaluation command. . . . test. I 

configuration information. uvar.2 

conf^ure the LP spooling Ipadmin. Im 

connect accounting records. ..... fwtmp. Im 

connect: initiate a connection .... connect.2n 

connection, dial: establish dial.3c 

connection on a socket accept.2n 

connection on a socket connect.2n 

connect-time accounting acctcon.lm 

consistency check and/ fsck.lm 

constant-width text for troff cw. 1 

construct a file system mkfslb.lm 

construct a file system. . mkfs.lm 

construct argument list(s) and .... xargs. 1 

constructs, deroff: remove deroff.l 

contents of directories ls.l 

contents of directory Is7.1 

context split csplit. 1 

control fcntl.2 

control, uustat: uustat.lc 

control vc.l 

control characters asa.l 

control device ioctl. 2 

control initialization init.lm 

control operations msgctl.2 

control operations semctl.2 

control operations shmctl.2 

control options fcntl.S 

Control Protocol tcp.Sn 

controlling terminal tty.7 

conventional names for term.5 

conversion program units. 1 

convert and copy a file dd. 1 

convert Arabic numerals to number.6 

convert ASCII string to atof.Sc 

convert between 3-byte 13tol.3c 

convert between long integer .... h641.3c 

convert date and time to/ ctime.3c 

convert floating-point number .... ecvt.3c 

convert formatted input scanf.3s 

convert string to integer strtol.3c 

convert to antique media bcd.6 

copy bcopy.lm 

copy rcp.ln 

copy, uucp, uucp.lc 

copy, /uupick: public UNIX uuto.lc 

copy a file dd.l 

copy file archives in and out cpio.l 

copy file systems for optimal .... dcopy. Im 

copy file systems with label volcopy. Im 

copy, link or move files cp.l 

core: format of core image core.4 

core image file core.4 

core memory mem.7 

cos, tan, asin, acos, atan, trig.3m 

cosh, tanh: hyperbolic sinh.3m 

count wc.l 

count blocks in a file sum7.1 

count characters in the files sumdir. 1 

count of a file sum.l 

cp. In, mv: copy, link or move .... cp.l 

cpio archive cpio.4 

cpio: copy file archives in cpio.l 
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preprocessor. 

sethostname: set name of host 

clock: report 

craps: the game of 

system crashes. 

what to do when the system 

rewrite an existing one. 

file, tmpnam, tempnam: 

an existing one. creat: 

fork: 

tmpfile: 

communication, socket: 

by massaging C source, mkstr: 

channel, pipe: 

files, admin: 

umask: set and get file 

cribbage: the card game 

cribbage. 

cxref: generate C program 
more: file perusal filter for 

generate DES encryption, 
interpreter) with C-like/ 

terminal. 

for a C program. 

for terminal. 

asctime, tzset: convert date/ 

ttt, 

gethostname: get name of 

hostname: set or print name of 

activity, sact: print 

uname: print name of 

uname: get name of 

slot in the utmp file of the 

getcwd: get pathname of 

spline: interpolate smooth 

name of the user. 

of each line of a file. 

each line of a file, cut: 

constant-width text for/ 

cross reference. 

cron: clock 

errdemon: error-logging 

terminate the error-logging 

runacct: run 

backup, filesave, tapesave: 

/handle special functions of 

special functions of the 

bit, bits 12: block transfer 

prof: display profile 

/time a command; report process 

termcap: terminal capability 

port, ttytype: 

/sgetl: access long numeric 

plock: lock process, text, or 

call. Stat: 

brk, sbrk: change 

types: primitive system 

join: relational 



cpio: format of cpio archive cpio.4 

cpp: the C language cpp.l 

cpu. sethostname.2n 

CPU time used clock.3c 

craps craps.6 

craps: the game of craps craps.6 

crash: what to do when the crash.8 

crashes, crash: crash.8 

creat: create a new file or creat.2 

create a name for a temporary .... tmpnam.3s 

create a new file or rewrite creat.2 

create a new process fork. 2 

create a temporary file tmpfile.3s 

create an endpoint for socket.2n 

create an error message file mkstr. 1 

create an interprocess pipe.2 

create and administer SCCS admin. 1 

creation mask umask.2 

cribbage cribbage.6 

cribbage: the card game cribbage.6 

cron: clock daemon cron.lm 

cross reference cxref. 1 

crt viewing more.l 

crypt: encode/decode crypt.l 

crypt, setkey, encrypt: crypt.3c 

csh: a shell (command csh.l 

csplit: context split csplit.l 

ct: spawn getty to a remote ct.lc 

ctags: maintain a tags file ctags.l 

ctermid: generate file name ctermid.Ss 

ctime, localtime, gmtime, ctime.Sc 

cu: call another UNIX System cu.lc 

cubic: tic-tac-toe ttt.6 

current host gethostname.2n 

current host system hostname. In 

current SCCS file editing sact.l 

current UNIX System uname. 1 

current UNIX system uname.2 

current user, /find the ttyslot.3c 

current working directory getcwd.Sc 

curve spline.lg 

cuserid: get character login cuserid.3s 

cut: cut out selected fields cut.l 

cut out selected fields of cut.l 

cw, checkcw: prepare cw.l 

cxref: generate C program cxref. 1 

daemon cron.lm 

daemon errdemon. Im 

daemon, errstop: errstop.lm 

daily accounting runacct. Im 

daily/ weekly UNIX file system .... filesave. Im 

DASI 300 and 300s terminals 300.1 

DASI 450 terminal, /handle 450.1 

data blt.3 

data prof.l 

data and system activity timex.l 

data base termcap.5 

data base of terminal types by .... ttytype.4 

data in a machine independent/ . . . sputl.3x 

data in memory plock.2 

data returned by stat system stat.5 

data segment space allocation brk. 2 

data types types.5 

database operator join. 1 
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udp: Internet User 

date: print and set the 

/asctime, tzset: convert 



optimal access time. 

adb: 

fsdb: file system 

eqnchar: special character 

netmailer: 

people, delivermail: 

names, basename, dirname: 

file, tail: 

aliases: aliases file for 

arbitrary people. 

delta commentary of an SCCS 

file, delta: make a 

delta, cdc: change the 

rmdel: remove a 

to an SCCS file. 

comb: combine SCCS 

mesg: permit or 

tbl, and eqn constructs. 

setkey, encrypt: generate 

close: close a hie 

dup: duplicate an open file 

dc: 

file, access: 

file: 

errors in the specified 

ioctl: control 

master: master 

devnm: 

blocks. 

check and interactive/ fsck, 

terminal line connection. 

bdiff: big 

comparator. 

diffdir: 

comparison. 

sdifT: side-by-side 

diffmk: mark 

diff: 

diffS: 3-way 

between files. 



diffdir: diff 

dir: format of 

Is: list contents of 

rm, rmdir: remove files or 

in the files in the given 

cd: change working 

chdir: change working 

chroot: change root 

pathname of current working 

mkdir: make a 

mvdir: move a 

ls7: list contents of 

uuclean: uucp spool 

dircmp: 



Datagram Protocol udp.Sn 

date date.l 

date and time to string ctime.3c 

date: print and set the date date. 1 

dc: desk calculator del 

dcopy: copy file systems for dcopy.lm 

dd: convert and copy a file dd. 1 

debugger adb.l 

debugger fsdb.lm 

definitions for eqn and neqn eqnchar.S 

deliver mail to netmailer.Sn 

deliver mail to arbitrary delivermail.Sn 

deliver portions of path basename. 1 

deliver the last part of a tail.l 

delivermail aliases.7n 

delivermail: deliver mail to delivermail.Sn 

delta, cdc: change the cdc.l 

delta (change) to an SCCS delta. 1 

delta commentary of an SCCS .... cdc.l 

delta from an SCCS file rmdel. 1 

delta: make a delta (change) delta. 1 

deltas comb.l 

deny messages mesg.l 

deroff: remove nroff/troff, deroff.l 

DES encryption, crypt, crypt.3c 

descriptor close.2 

descriptor dup.2 

desk calculator dc. 1 

determine accessibility of a access.2 

determine file type file.l 

device, /on/ off the extended .... exterr.l 

device ioctl.2 

device information table master.4 

device name devnm.lm 

devnm: device name devnm.lm 

df: report number of free disk . . . . df.lm 

dfsck: file system consistency .... fsck.lm 

dial: establish an out-going dial.3c 

diff. bdiff".! 

diff: differential file diff.l 

diff directories diffdir. 1 

diff3: 3-way differential file difr3.1 

diffdir: diff directories diffdir. 1 

difference program sdiff.l 

differences between files. diffmk. 1 

differential file comparator diff.l 

differential file comparison diff 3.1 

diffmk: mark differences diffmk. 1 

dir: format of directories dir.4 

dircmp: directory comparison dircmp. 1 

directories diffdir. 1 

directories dir.4 

directories Is.l 

directories rm.l 

directories, /count characters .... sumdir.l 

directory cd.l 

directory chdir.2 

directory chroot.2 

directory, getcwd: get getcwd.3c 

directory mkdir.l 

directory mvdir.lm 

directory (Berkeley version) Is7.1 

directory clean-up uuclean. Im 

directory comparison dircmp.l 
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unlink: remove 

chroot: change root 

/make a lost + found 

pwd: working 

ordinary file, mknod: make a 

path names, basename, 

printers, enable, 

acct: enable or 

type, modes, speed, and line 

diskformat - format a 

sadp: 

df: report number of free 

disktune - tune floppy 

du: summarize 

settling time parameters. 

mount, umount: mount and 

rain: animated raindrops 

/view: screen oriented (visual) 

prof: 

worms: animate worms on a 

hypot: Euclidean 

/lcong48: generate uniformly 

macro package for formatting 

macro package for formatting 

mm, osdd, checkmm: print/check 

slides, mmt, mvt: typeset 

nulladm,/ chargefee, ckpacct, 

whodo: who is 

suitable for Motorola S-record 

/Motorola S-records from 

nrand48, mrand48, jrand48,/ 

arithmetic: provide 

extract error records from 

od: octal 

descriptor. 

descriptor, dup: 

The alien invaders attack the 

echo: 

floating-point number to/ 

program, end, etext, 

ex, 

sact: print current SCCS file 

ed, red: text 

ex, edit: text 

Id: link 

sed: stream 

oriented (visual) display 

a.out: assembler and link 

/user, real group, and 

and/ /getegid: get real user. 

Language. 

split fortran, ratfor, or 

for a pattern, grep, 

enable/disable LP printers. 

accounting, acct: 

enable, disable: 

crypt: 

encryption, crypt, setkey, 

■ setkey, encrypt: generate DES 

makekey: generate 



directory entry unlink.2 

directory for a command. ...... chroot. Im 

directory for fsck. ......... mklost+fnd.lm 

directory name pwd.l 

directory, or a special or mknod.2 

dirname: deliver portions of basename. 1 

disable: enable/disable LP enable. 1 

disable process accounting acct.2 

discipline, /set terminal getty.lm 

disk diskformat. Im 

disk access profiler sadp.l 

disk blocks df.lm 

disk settling time parameters disktune. Im 

disk usage du.l 

diskformat - format a disk diskformat.lm 

disktune - tune floppy disk disktune. Im 

dismount file system mount.lm 

display rain.6 

display editor based on ex vi.l 

display profile data prof.l 

display terminal. worms.6 

distance function. hypot.Sm 

distributed pseudo-random/ drand48.3c 

documents, mm: the MM mm. 5 

documents, /the OSDD adapter . . . mosd.5 

documents formatted with the/ . . . mm.l 

documents, view graphs, and .... mmt.l 

dodisk, lastlogin, monacct, acctsh.lm 

doing what whodo. Im 

downloading. /ASCII formats .... hex.l 

downloading into a file rcvhex.l 

drand48, erand48, lrand48, drand48.3c 

drill in number facts arithmetic.6 

du: summarize disk usage du.l 

dump, errdead: errdead.lm 

dump od.l 

dup: duplicate an open file dup.2 

duplicate an open file dup.2 

earth, aliens: aliens.6 

echo arguments echo.l 

echo: echo arguments echo.l 

ecvt, fcvt, gcvt: convert ....... ecvt.3c 

ed, red: text editor ed.l 

edata: last locations in end.3c 

edit: text editor ex.1 

editing activity sact. I 

editor ed.l 

editor ex.1 

editor Id.l 

editor sed.l 

editor based on ex. /screen vi.l 

editor output a.out.4 

effective group IDs getuid.2 

effective user, real group, getuid.2 

efl: Extended Fortran efl.l 

efl files, fsplit: fsplit.l 

egrep, fgrep: search a file grep.l 

enable, disable: enable. 1 

enable or disable process acct.2 

enable/disable LP printers enable. 1 

encode/decode crypt. 1 

encrypt: generate DES crypt.3c 

encryption, crypt, . crypt.3c 

encryption key makekey. 1 
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locations in program. 

/getgrgid, getgrnam, setgrent, 

socket: create an 

/getpwuid, getpwnam, setpwent, 

utmp/ /pututline, setutent, 

convert Arabic numerals to 

nlist: get 

man, manprog: print 

man: macros for formatting 

endgrent: get group file 

endpwent: get password file 

utmpname: access utmp file 

putpwent: write password file 

unlink: remove directory 

utmp, wtmp: utmp and wtmp 

command execution. 



environ: user 

environ: user 

printenv: print out the 

profile: setting up an 

execution, env: set 

getenv: return value for 

character definitions for 

remove nroff/troff, tbl, and 

mathematical text for nroif/ 

definitions for eqn and neqn. 

mrand48, jrand48,/ drand48, 

complementary error function. 

complementary error/ erf, 

from dump. 

daemon. 

format. 

system error/ perror, 

function and complementary 

complementary/ erf, erfc: 

massaging C/ mkstr: create an 

sys_errlist, sys_nerr: system 

to system calls and 

errdead: extract 

matherr: 

errfile: 

errdemon: 

errstop: terminate the 

err: 

process a report of logged 

hashcheck: find spelling 

/- turn on/ off the extended 

logged errors. 

error-logging daemon. 

robots, autorobots: 

robots: 

chase: Try to 

terminal line/ dial: 

setmnt: 

bnet. 

in program, end, 

hypot: 

expression, expr: 

test: condition 

display editor based on 



end, etext, edata: last end.3c 

endgrent: get group file/ getgrent.3c 

endpoint for communication socket.2n 

endpwent: get password file/ .... getpwent.3c 

endutent, utmpname: access getut.3c 

English, number: number.6 

entries from name list nlist.3c 

entries in this manual man.l 

entries in this manual man.5 

entry, /getgrnam, setgrent, getgrent.3c 

entry, /getpwnam, setpwent getpwent.3c 

entry, /setutent, endutent, getut.3c 

entry putpwent.3c 

entry unlink.2 

entry formats utmp.4 

env: set environment for env.l 

environ: user environment environ.4 

environ: user environment environ.5 

environment environ.4 

environment environ.5 

environment printenv. 1 

environment at login time profile.4 

environment for command env.l 

environment name getenv.3c 

eqn and neqn. /special eqnchar.5 

eqn constructs, deroff: deroif.l 

eqn, neqn, checkeq: format eqn.l 

eqnchar: special character eqnchar.5 

erand48, lrand48, nrand48, drand48.3c 

erf, erfc: error function and erf.3m 

erfc: error function and erf.3m 

err: error-logging interface err.7 

errdead: extract error records .... errdead. Im 

errdemon: error-logging errdemon. Im 

errfile: error-log file errfile.4 

errno, sys_errlist, sys_nerr: perror.3c 

error function, /erfc: error erf.3m 

error function and erf.3m 

error message file by mkstr. 1 

error messages, /errno, . perror.3c 

error numbers, /introduction .... intro.2 

error records from dump . errdead. Im 

error-handling function matherr.3m 

error-log file format errfile.4 

error-logging daemon errdemon. Im 

error-logging daemon errstop. Im 

error-logging interface err.7 

errors, errpt: errpt.lm 

errors, /hashmake, spellin spell. 1 

errors in the specified/ exterr.l 

errpt: process a report of errpt. Im 

errstop: terminate the errstop. Im 

Escape from the automatic autorobots.6 

Escape from the robots robots.6 

escape the killer robots chase.6 

establish an out-going dial.3c 

establish mount table setmnt. Im 

/etc/hosts: host table for hosts.7n 

etext, edata: last locations end.3c 

Euclidean distance function hypot.3m 

evaluate arguments as an expr.l 

evaluation command test.l 

ex. /screen oriented (visual) . . . . vi.l 

ex, edit: text editor ex.1 
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reading or/ lockf: provide 

execip, execvp: execute a/ 

execvp: execute/ execl, execv, 

execl, execv, execle, execve, 

execve, execip, execvp: 

construct argument list(s) and 

time, at: 

regcmp, regex: compile and 

set environment for command 

uux: Unix to unix command 

sleep: suspend 

sleep: suspend 

monitor: prepare 

profil: 

execvp: execute a/ execl, 

execute/ execl, execv, execle, 

/execv, execle, execve, execip, 

system calls, link, unlink: 

a new file or rewrite an 

process. 

exit, 

exponential, logarithm,/ 

peat, unpack: compress and 

adventure: an 

exp, log, log 10, pow, sqrt: 

expression. 

expr: evaluate arguments as an 

compile and execute regular 

regcmp: regular 

routines, regexp: regular 

exterr - turn on/off the 

efl: 

greek: graphics for the 

extended errors in the/ 

dump, errdead: 

remainder,/ floor, ceil, fmod, 

factor: 

true, 

data in a machine independent 

fine: 

abort: generate an lOT 

a stream. 



floating-point number/ ecvt, 

fopen, freopen, 

status inquiries, ferror, 

fiieno: stream status/ 

statistics for a file system. 

stream, fclose, 

word from/ getc, getchar, 

stream, gets, 

pattern, grep, egrep, 

determine accessibility of a 

chmod: change mode of 

change owner and group of a 

core: format of core image 

fields of each line of a 

dd: convert and copy a 

a delta (change) to an SCCS 

execip, execvp: execute a 

on character frequencies in a 

get: get a version of an SCCS 



exclusive file regions for lockf.2 

execl, execv, execle, execve, .... exec.2 

execle, execve, execip, exec.2 

execip, execvp: execute a/ exec.2 

execute a file, /execle, exec.2 

execute command, xargs: xargs.l 

execute commands at a later .... at. 1 

execute regular expression regcmp.3x 

execution, env: env.l 

execution uux.lc 

execution for an interval sleep. 1 

execution for interval sleep.3c 

execution profile monitor.Sc 

execution time profile profil.2 

execv, execle, execve, execip, .... exec.2 

execve, execip, execvp: exec.2 

execvp: execute a file exec.2 

exercise link and unlink link.lm 

existing one. creat: create creat.2 

exit, _exit: terminate exit.2 

exit: terminate process exit.2 

exp, log, loglO, pow, sqrt: exp.3m 

expand files, pack, pack.l 

exploration game adventure.6 

exponential, logarithm, power,/ . . . exp.3m 

expr: evaluate arguments as an ... expr.l 

expression expr.l 

expression, regcmp, regex: regcmp.3x 

expression compile regcmp.l 

expression compile and match .... regexp.5 

extended errors in the/ exterr. 1 

Extended Fortran Language efl.l 

extended TTY-37 type-box greek. 5 

exterr - turn on/ off" the exterr. 1 

extract error records from errdead. Im 

fabs: floor, ceiling, floor.3m 

factor a number factor. 1 

factor: factor a number factor. 1 

false: provide truth values true.l 

fashion., /access long numeric .... sputl.3x 

fast incremental backup finc.lm 

fault abort.3c 

fclose, filush: close or flush fclose.3s 

fcntl: file control fcntl.2 

fcntl: file control options fcntl.5 

fcvt, gcvt: convert ecvt.3c 

fdopen: open a stream fopen.3s 

feof, clearerr, fiieno: stream ferror.3s 

ferror, feof, clearerr, ferror.3s 

ff: list file names and If.lm 

fflush: close or flush a fclose.3s 

fgetc, getw: get character or getc.3s 

fgets: get a string from a gets.3s 

fgrep: search a file for a grep.l 

file, access: access.2 

file chmod.2 

file, chown: chown.2 

file core.4 

file, cut: cut out selected cut.l 

file dd.l 

file, delta: make delta. 1 

file, /execv, execle, execve, exec.2 

file, freq: report freq.l 

file get.l 
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group: group file group.4 

issue: issue identification file issue.4 

link: link to a file link.2 

mknod: build special file niknod.lm 

or a special or ordinary file, /make a directory, mknod.2 

change the format of a text file, newform: newform.l 

null: the null file null.7 

passwd: password file passwd.4 

or subsequent lines of one file. /lines of several files paste. 1 

prs: print an SCCS file prs. 1 

from downloading into a file. /Motorola S-records ...... rcvhex.l 

read: read from file read.2 

remove a delta from an SCCS file, rmdel: rmdel.l 

two versions of an SCCS file, sccsdiff: compare sccsdiff.l 

sccsfile: format of SCCS file sccsfile.4 

size: size of an object file size.l 

in an object, or other binary file, /the printable strings strings.] 

checksum and block count of a file, sum: print sum.l 

sum and count blocks in a file. sum7: sum7.1 

deliver the last part of a file, tail: tail.l 

tmpfile: create a temporary file tmpfile.3s 

create a name for a temporary file, tmpnam, tempnam: tmpnam.3s 

and modification times of a file, touch: update access touch. 1 

undo a previous get of an SCCS file, unget: unget.1 

report repeated lines in a file, uniq: uniq.l 

val: validate SCCS file val.l 

write: write on a file write.2 

times, utime: set file access and modification utime.2 

hpio: HP 2645 A terminal tape file archiver hpio.l 

tar: tape file archiver tar.l 

cpio: copy file archives in and out cpio.l 

mkstr: create an error message file by massaging C source mkstr.l 

pwck, grpck: password/ group file checkers pwck.lm 

diff: differential file comparator diff.l 

diff3: 3-way differential file comparison diff3.1 

-fcntl: file control fcntl.2 

fcnti: file control options fcntLS 

rep: remote file copy rcp.ln 

UNIX System-to-UNIX System file copy, /uupick: public uuto.lc 

umask: set and get file creation mask umask.2 

close: close a file descriptor close.2 

dup: duplicate an open file descriptor dup.2 

file: determine file type file.l 

sact: print current SCCS file editing activity sact.l 

setgrent, endgrent: get group file entry, /getgrnam, getgrent.3c 

endpwent: get password file entry, /setpwent, getpwent.3c 

utmpname: access utmp file entry, /endutent, getut.3c 

putpwent: write password file entry putpwent.3c 

ctags: maintain a tags file for a C program ctags.l 

grep, egrep, fgrep: search a file for a pattern grep.l 

aliases: aliases file for delivermail aliases.7n 

acct: per-process accounting file format acct.4 

ar: archive (library) file format ar.4 

errfile: error-log file format errfile.4 

pnch: file format for card images pnch.4 

intro: introduction to file formats intro.4 

take: takes a file from a remote machine take.lc 

take7: takes a file from a remote machine take7.1c 

split: split a file into pieces split. 1 

mktemp: make a unique file name mktemp.3c 

ctermid: generate file name for terminal. ctermid.3s 

a file system, ff: list file names and statistics for ff.lm 

/find the slot in the utmp file of the current user ttyslot.3c 

put: puts a file onto a remote machine put.lc 
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put7: puts a 

/identify processes using a 

one. creat: create a new 

viewing, more: 

Iseek: move read/write 

/rewind, fteil: reposition a 

lockf: provide exclusive 

bfs: big 

Stat, fstat: get 

processes using a file or 

names and statistics for a 

mkfslb: construct a 

mkfs: construct a 

umount: mount and dismount 

mount: mount a 

umount: unmount a 

tapesave: daily/weekly UNIX 

and interactive/ fsck, dfsck: 

fsdb: 

volume. 

ustat: get 

mnttab: mounted 

access time, dcopy: copy 

fsck. checklist: list of 

volcopy, labelit: copy 

ftw: walk a 

file: determine 

umask: set 

ferror, feof, clearerr, 

and print process accounting 

merge or add total accounting 

create and administer SCCS 

cat: concatenate and print 

cmp: compare two 

lines common to two sorted 

cp, In, mv: copy, link or move 

mark differences between 

find: find 

format specification in text 

fortran, ratfor, or efl 

string, format of graphical 

intro: introduction to special 

unpack: compress and expand 

pr: print 

sort: sort and/ or merge 

reports version number of 

what: identify SCCS 

updater: update 

updater: update 

free: recover 

and count characters in the 

hex: translates object 

rm, rmdir: remove 

/merge same lines of several 

daily/weekly UNIX file system/ 

greek: select terminal 

nl: line numbering 

more: file perusal 

col: 

tplot: graphics 

find: 

hyphen: 



file onto a remote machine put7.1c 

file or file structure fuser.lm 

file or rewrite an existing creat.2 

file perusal filter for crt more.l 

file pointer lseek.2 

file pointer in a stream fseek.3s 

file regions for reading or/ lockf.2 

file scanner bfs.l 

file status stat.2 

file structure, /identify fuser.lm 

file system, ff: list file fT.lm 

file system mkfslb.lm 

file system mkfs.lm 

file system, mount, mount. Im 

file system mount.2 

file system umount.2 

file system backup, filesave, filesave.lm 

file system consistency check .... fsck.lm 

file system debugger fsdb.lm 

file system: format of system .... fs.4 

file system statistics ustat.2 

file system table mnttab.4 

file systems for optimal dcopy. Im 

file systems processed by checklist.4 

file systems with label/ volcopy. Im 

file tree ftw.3c 

file type file.l 

file-creation mode mask umask. 1 

fileno: stream status/ ferror.3s 

file(s). acctcom: search acctcom.l 

files, acctmerg: acctmerg.lm 

files, admin: admin. 1 

files cat.l 

files cmp.l 

files, comm: select or reject comm.l 

files cp.l 

files, diffmk: diffmk.l 

files find.l 

files, fspec: fspec.4 

files, fsplit: split fsplit.l 

files, /graphical primitive gps.4 

files. intro.7 

files, pack, peat, pack.l 

files pr.l 

files sort.l 

files, version: version. 1 

files what.l 

files between two machines updater. I 

files between two machines updater.lm 

files from a backup tape frec.lm 

files in the given/ /sum sumdir.l 

files into ASCII formats/ hex.l 

files or directories . . rm.l 

files or subsequent lines of/ paste. 1 

filesave, tapesave: filesave.lm 

filter greek. 1 

filter nl.l 

filter for crt viewing more.l 

filter reverse line-feeds col.l 

filters tplot.lg 

fine: fast incremental backup finc.lm 

find files find.l 

find: find files find.l 

find hyphenated words hyphen. 1 
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ttyname, isatty: 

object library, lorder: 

hashmake, spellin, hashcheck: 

an object, or other/ strings: 

of the current user, ttyslot: 

fish: play "Go 

a command immune to hangups 

tee: pipe 

atof: convert ASCII string to 

ecvt, fcvt, gcvt: convert 

/'modf: manipulate parts of 

floor, ceiling, remainder,/ 

floor, ceil, fmod, fabs: 

parameters, disktune - tune 

cflow: generate C 

fclose, fflush: close or 

remainder,/ floor, ceil, 

stream. 

per-process accounting file 

ar: archive (library) file 

errfile: error-log file 

tp: magnetic tape 

diskformat - 

pnch: file 

nrofl" or/ eqn, neqn, checkeq: 

newform: change the 

inode: 

core: 

cpio: 

dir: 

/graphical primitive string, 

sccsfiie: 

file system: 

files, fspec: 

troff". tbl: 

nroff: 

intro: introduction to file 

wtmp: utmp and wtmp entry 

/object files into ASCII 

scanf, fscanf, sscanf: convert 

fprintf, sprintf: print 

/checkmm: print/check documents 

mptx: the macro package for 

nroff?: text 

troff7: text 

mm: the MM macro package for 

OSDD adapter macro package for 

manual, man: macros for 

efl: Extended 

files, fsplit: split 

hopefully interesting, adage. 

formatted output, printf, 

word on a/ putc, putchar, 

stream, puts, 

input/ output. 

backup tape. 

df: report number of 

memory allocator, malloc, 

stream, fopen, 

frequencies in a file. 

freq: report on character 

parts of floating-point/ 



find name of a terminal ttyname.3c 

find ordering relation for an lorder. 1 

find spelling errors, spell, spell. 1 

find the printable strings in strings.! 

find the slot in the utmp file ttyslot.3c 

Fish" fish.6 

fish: play "Go Fish" fish.6 

(.sh only), nohup: run nohup.l 

fitting tee.l 

floating-point number atof.3c 

floating-point number to/ ecvt.Bc 

floating-point numbers frexp.3c 

floor, ceil, fmod, fabs: floor.3m 

floor, ceiling, remainder,/ floor.3m 

floppy disk settling time disktune. Im 

flow graph cflow.l 

flush a stream fclose.3s 

fmod, fabs: floor, ceiling, floor.3m 

fopen, freopen, fdopen: open a ... fopen.3s 

fork: create a new process. ..... fork.2 

format, acct: acct.4 

format ar.4 

format errfile.4 

format tp.4 

format a disk diskformat. Im 

format for card images pnch.4 

format mathematical text for .... eqn.l 

format of a text file newform.l 

format of an inode inode.4 

format of core image file core.4 

format of cpio archive cpio.4 

format of directories dir.4 

format of graphical files gps.4 

format of sees file sccsfile.4 

format of system volume fs.4 

format specification in text fspec.4 

format tables for nrofl" or tbi.l 

format text nroff.l 

formats intro.4 

formats, utmp, utmp.4 

formats suitable for Motorola/ .... hex.l 

formatted input scanf.3s 

formatted output, printf, printf.3s 

formatted with the MM macros. . . . mm.l 

formatting a permuted index mptx.5 

formatting and typesetting nrofll.l 

formatting and typesetting troff"7.1 

formatting documents mm.5 

formatting documents, /the mosd.5 

formatting entries in this man.5 

Fortran Language efl.l 

fortran, ratfor, or efl fsplit. 1 

fortune: print a random, fortune.6 

fprintf, sprintf: print printf.3s 

fputc, putw: put character or putc.3s 

fputs: put a string on a puts.3s 

fread, fwrite: binary fread.3s 

free: recover files from a frec.lm 

free disk blocks df.lm 

free, realloc, calloc: main malloc.3c 

freopen, fdopen: open a fopen.3s 

freq: report on character freq.l 

frequencies in a file freq.l 

frexp, Idexp, modf: manipulate . . . frexp.3c 
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free: recover files 

take: takes a file 

take?: takes a file 

receive: receive message 

send: send message 

gets, fgets: get a string 

rmdel: remove a delta 

getopt: get option letter 

/translates Motorola S-records 

errdead: extract error records 

read: read 

ncheck: generate names 

nlist: get entries 

acctcms: command summary 

getw: get character or word 

autorobots: Escape 

robots: Escape 

getpw: get name 

formatted input, scanf, 

of file systems processed by 

a lost + found directory for 

consistency check and/ 

reposition a file pointer in/ 

text files. 

or efl files. 

Stat, 

pointer in a/ fseek, rewind, 

and complementary error 

gamma: log gamma 

hypot: Euclidean distance 

matherr: error-handling 

error/ erf, erfc: error 

jO, jl, jn, yO, yl, yn: Bessel 

logarithm, power, square root 

remainder, absolute value 

sinh, cosh, tanh: hyperbolic 

atan, atan2: trigonometric 

300, 300s: handle special 

hp: handle special 

terminal. 450: handle special 

using a file or file/ 

fread, 

connect accounting records. 

adventure: an exploration 

moo: guessing 

trek: trekkie 

worm: Play the growing worm 

cribbage: the card 

back: the 

bj: the 

' craps: the 

wump: the 

life: play the 

intro: introduction to 

gamma: log 

number to string, ecvt, fcvt, 

maze: 

abort: 

cflow: 

reference, cxref: 

crypt, setkey, encrypt: 



from a backup tape frec.lm 

from a remote machine take.lc 

from a remote machine take7.1c 

from a socket receive. 2n 

from a socket send.2 

from a stream gets.3s 

from an SCCS file rmdel. 1 

from argument vector getopt.3c 

from downloading into a file rcvhex.l 

from dump errdead.lm 

from file read.2 

from i-numbers ncheck. Im 

from name list nlist.3c 

from per-process accounting/ .... acctcms. Im 

from stream, /getchar, fgetc getc.3s 

from the automatic robots autorobots.6 

from the robots robots.6 

from UID getpw.3c 

fscanf, sscanf: convert scanf.3s 

fsck. checklist: list checklist.4 

fsck. mklost+found: make mklost+fnd.lm 

fsck, dfsck: file system fsck.lm 

fsdb: file system debugger fsdb.lm 

fseek, rewind, ftell: fseek.3s 

fspec: format specification in fspec.4 

fsplit: split fortran, ratfor, fsplit.l 

fstat: get file status stat.2 

ftell: reposition a file fseek.3s 

ftw: walk a file tree ftw.3c 

function, /error function erf.3m 

function gamma.3m 

function hypot.3m 

function matherr.3m 

function and complementary .... erf.3m 

functions bessel.3m 

functions, /sqrt: exponential exp.3m 

functions, /floor, ceiling floor.3m 

functions sinh.3m 

functions, /tan, asin, acos, trig.3m 

functions of DASI 300 and 300s/ . . 300.1 

functions of HP 2640 and/ hp.l 

functions of the DASI 450 450.1 

fuser: identify processes fuser.lm 

fwrite: binary input/output fread.3s 

fwtmp, wtmpfix: manipulate fwtmp.lm 

game adventure.6 

game moo.6 

game trek.6 

game worm.6 

game cribbage cribbage.6 

game of backgammon back.6 

game of black jack bj.6 

game of craps craps.6 

game of hunt-the-wumpus wump.6 

game of life life.6 

games intro.6 

gamma function gamma.3m 

gamma: log gamma function gamma.3m 

gcvt: convert floating-point ecvt.3c 

generate a maze maze.6 

generate an lOT fault abort.3c 

generate C flow graph cflow. 1 

generate C program cross cxref 1 

generate DES encryption crypt.3c 
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makekey: 

terminal, ctermid: 

ncheck: 

lexical tasks, lex: 

/srand48, seed48, lcong48: 

srand: simple random-number 

gets, fgets: 

get: 

ulimit: 

the user, cuserid: 

getc, getchar, fgetc, getw: 

nlist: 

umask: set and 

Stat, fstat: 

ustat: 

file. 

/getgrnam, setgrent, endgrent: 

getlogin: 

logname: 

msgget: 

getpw: 

gethostname: 

system, uname: 

unget: undo a previous 

argument vector, getopt: 

/getpwnam, setpwent, endpwent: 

working directory, getcwd: 

times, times: 

and/ getpid, getpgrp, getppid: 

/geteuid, getgid, getegid: 

semget: 

shmget: 

tty: 

time: 

get character or word from/ 

character or word from/ getc, 

current working directory. 

getuid, geteuid, getgid, 

environment name. 

real user, effective/ getuid, 

user,/ getuid, geteuid, 

setgrent, endgrent: get group/ 

endgrent: get group/ getgrent, 

get group/ getgrent, getgrgid, 

current host. 

argument vector. 



process group, and/ getpid, 
process, process group, and/ 
group, and/ getpid, getpgrp, 

setpwent, endpwent: get/ 

get/ getpwent, getpwuid, 

endpwent: get/ getpwent, 

a stream. 

and terminal settings used by 

modes, speed, and line/ 

ct: spawn 

settings used by getty. 

getegid: get real user,/ 

pututline, setutent,/ 

setutent, endutent,/ getutent. 



generate encryption key makekey. 1 

generate file name for ctermid.3s 

generate names from i-numbers. . . . ncheck. 1 m 

generate programs for simple .... lex.l 

generate uniformly distributed/ . . . drand48.3c 

generator, rand, rand.3c 

get a string from a stream gets.3s 

get a version of an SCCS file. .... get. 1 

get and set user limits ulimit.2 

get character login name of cuserid.3s 

get character or word from/ getc.3s 

get entries from name list niist.3c 

get file creation mask. umask.2 

get file status stat.2 

get file system statistics ustat.2 

get: get a version of an SCCS .... get. 1 

get group file entry getgrent.3c 

get login name getlogin.3c 

get login name logname. 1 

get message queue msgget.2 

get name from UID getpw.3c 

get name of current host gethostname.2n 

get name of current UNIX uname.2 

get of an SCCS file unget. 1 

get option letter from getopt.3c 

get password file entry getpwent.3c 

get pathname of current getcwd. 3c 

get process and child process .... times.2 

get process, process group, getpid.2 

get real user, effective user,/ .... getuid.2 

get set of semaphores semget.2 

get shared memory segment shmget.2 

get the terminal's name tty. 1 

get time time.2 

getc, getchar, fgetc, getw: getc.3s 

getchar, fgetc, getw: get getc.3s 

getcwd: get pathname of getcwd.3c 

getegid: get real user,/ getuid.2 

getenv: return value for getenv.3c 

geteuid, getgid, getegid: get ..... getuid.2 

getgid, getegid: get real getuid.2 

getgrent, getgrgid, getgrnam, .... getgrent.3c 

getgrgid, getgrnam, setgrent, .... getgrent.3c 

getgrnam, setgrent, endgrent: .... getgrent.3c 

gethostname: get name of gethostname.2n 

getlogin: get login name getlogin.3c 

getopt: get option letter from .... getopt.3c 

getopt: parse command options. . . . getopt. 1 

getpass: read a password getpass.3c 

getpgrp, getppid: get process, .... getpid.2 

getpid, getpgrp, getppid: get getpid.2 

getppid: get process, process getpid.2 

getpw: get name from UID getpw.3c 

getpwent, getpwuid, getpwnam, . . . getpwent.3c 

getpwnam, setpwent, endpwent: . . . getpwent.3c 

getpwuid, getpwnam, setpwent, . . . getpwent.3c 

gets, fgets: get a string from gets.3s 

getty. gettydefs: speed gettydefs.4 

getty: set terminal type, getty. Im 

getty to a remote terminal ct.lc 

gettydefs: speed and terminal .... gettydefs.4 

getuid, geteuid, getgid, getuid.2 

getutent, getutid, getutline, getut.3c 

getutid, getutline, pututline, getut.3c 
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setutent,/ getutent, getutid, 

from/ getc, getchar, fgetc, 

convert/ ctime, localtime, 

fish: play 

setjmp, longjmp: non-local 

string, format of graphical/ 

cflow: generate C flow 

sag: system activity 

primitive string, format of 

format of graphical/ gps: 

tplot: 

TTY-37 type-box. greek: 

plot: 

subroutines, plot: 

mvt: typeset documents, view 

package for typesetting view 

extended TTY-37 type-box. 

file for a pattern. 

chown, chgrp: change owner or 

newgrp: log in to a new 

/user, effective user, real 

/getppid: get process, process 

group: 

setgrent, endgrent: get 

setpgrp: set process 

real group, and effective 

setuid, setgid: set user and 

id: print user and 

chown: change owner and 

a signal to a process or a 

update, and regenerate 

worm: Play the 

checkers, pwck, 

ssignal, 

hangman: 

moo: 

DASI 300 and 300s/ 300, 300s: 

2640 and 2621 -series/ hp: 

the DASI 450 terminal. 450: 

information for bad block 

nohup: run a command immune to 

hcreate, hdestroy: manage 

spell, hashmake, spellin, 

find spelling errors, spell, 

search tables, hsearch, 

tables, hsearch, hcreate, 

help: ask for 

into ASCII formats suitable/ 

fortune: print a random, 

get name of current 

sethostname: set name of 

ruptime: show 

set or print name of current 

/etc/ hosts: 

current host system. 

rhost, raddr: look up internet 

handle special functions of 

archiver. hpio: 

of HP 2640 and 2621 -series/ 

file archiver. 



getutline, pututline, getut.3c 

getw: get character or word getc.3s 

gmtime, asctime, tzset: ctime.3c 

"Go Fish" fish.6 

goto setjmp.3c 

gps: graphical primitive gps.4 

graph cflow. 1 

graph sag.lg 

graphical files, /graphical gps.4 

graphical primitive string, gps.4 

graphics filters tplot. Ig 

graphics for the extended greek.5 

graphics interface plot.4 

graphics interface plot.3x 

graphs, and slides, mmt, mmt.l 

graphs and slides, /macro mv.5 

greek: graphics for the greek.5 

greek: select terminal filter greek. 1 

grep, egrep, fgrep: search a grep.l 

group chown. 1 

group newgrp.l 

group, and eff'ective group/ getuid.2 

group, and parent process IDs getpid.2 

group file group.4 

group file entry, /getgrnam, getgrent.3c 

group: group file group.4 

group ID setpgrp.2 

group IDs. /effective user, getuid.2 

group IDs setuid.2 

group IDs and names id.l 

group of a file chown.2 

group of processes, /send kill.2 

groups of programs, /maintain, . . . make.l 

growing worm game worm.6 

grpck: password/ group file pwck.lm 

gsignal: software signals ssignal.3c 

guess the word hangman.6 

guessing game moo.6 

handle special functions of 300.1 

handle special functions of HP . . . . hp. 1 

handle special functions of 450.1 

handling, /alternate block altblk.4 

hangman: guess the word hangman.6 

hangups {sh only) nohup. 1 

hash search tables, hsearch, hsearch.3c 

hashcheck: find spelling/ spell. 1 

hashmake, spellin, hashcheck: .... spell. 1 

hcreate, hdestroy: manage hash . . . hsearch.3c 

hdestroy: manage hash search .... hsearch.3c 

help help.l 

help: ask for help help.l 

hex: translates object files hex.l 

hopefully interesting, adage fortune.6 

host, gethostname: gethostname.2n 

host cpu sethostname.2n 

host status of local machines ruptime. In 

host system, hostname: hostname.ln 

host table for bnet hosts.Tn 

hostname: set or print name of . . . hostname.ln 

hosts by name or address rhost.3n 

HP 2640 and 2621 -series/ hp: .... hp.l 

HP 2645 A terminal tape file hpio.l 

hp: handle special functions hp.l 

hpio: HP 2645 A terminal tape .... hpio.l 
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manage hash search tables. 

wump: the game of 

sinh, cosh, tanh: 

hyphen: find 

function. 

semaphore set or shared memory 

setpgrp: set process group 

and names. 

issue: issue 

file or file/ fuser: 

what: 

group, and parent process 

group, and effective group 

setgid: set user and group 

id: print user and group 

core: format of core 

pnch: file format for card 

only), nohup: run a command 

fine: fast 

long numeric data in a machine 

/tgoto, tputs: terminal 

for formatting a permuted 

ptx: permuted 

family. 

inittab: script for the 

initialization. 

init, telinit: process control 

/re, powerfail: system 

socket, connect: 

process, popen, pclose: 

process. 

clri: clear 

inode: format of an 

sscanf: convert formatted 

push character back into 

fread, fwrite: binary 

stdio: standard buffered 

fileno: stream status 

uustat: UUCP status 

install: 

atol, atoi: convert string to 

abs: return 

/164a: convert between long 

3-byte integers and long 

/ltol3: convert between 3-byte 

bcopy: 

system consistency check and 

print a random, hopefully 

err: error-logging 

loop: software loopback 

plot: graphics 

termio: general terminal 

tty: controlling terminal 

plot: graphics 

rhost, raddr: look up 

ip: 

inet: 

Protocol, tcp: 

Protocol, udp: 

spline: 

characters, asa: 



hsearch, hcreate, hdestroy: hsearch.3c 

hunt-the-wumpus wump.6 

hyperbolic functions sinh.3m 

hyphen: find hyphenated words. . . . hyphen.! 

hyphenated words hyphen. 1 

hypot: Euclidean distance hypot.3m 

id. /remove a message queue, .... ipcrm.l 

ID setpgrp.2 

id: print user and group IDs id.l 

identification file issue.4 

identify processes using a fuser. Im 

identify SCCS files what.l 

IDs. /get process, process getpid.2 

IDs. /effective user, real getuid.2 

IDs. setuid, setuid.2 

IDs and names id.l 

mage file core.4 

mages pnch.4 

mmune to hangups {sh nohup. 1 

ncremental backup finc.lm 

ndependent fashion., /access .... sputl.3x 

ndependent operation/ termcap.3 

ndex. /the macro package ..... mptx.5 

ndex ptx.l 

net: Internet protocol inet.Sn 

nit process inittab.4 

nit, telinit: process control init.lm 

nitialization init.lm 

nitialization shell scripts brc.lm 

nitiate a connection on a connect.2n 

nitiate pipe to/from a popen.3s 

nittab: script for the init inittab.4 

i-node clri.lm 

node inode.4 

node: format of an inode inode.4 

nput. scanf, fscanf, scanf.3s 

nput stream, ungetc: ungetc.3s 

nput/output. fread.3s 

nput/output package stdio.3s 

nquiries. /feof, clearerr, ferror.3s 

nquiry and job control uustat.lc 

nstall commands install. Im 

nstall: install commands install. Im 

nteger. strtol, strtol.3c 

nteger absolute value abs.3c 

nteger and base-64 ASCII/ h641.3c 

ntegers. /convert between 13tol.3c 

ntegers and long integers 13tol.3c 

nteractive block copy bcopy.lm 

nteractive repair, /file fsck.lm 

nteresting, adage, fortune: fortune.6 

nterface err.7 

nterface lo.5n 

nterface plot.4 

nterface termio.7 

interface tty.7 

interface subroutines pIot.3x 

nternet hosts by name or/ rhost.3n 

Internet Protocol ip.5n 

Internet protocol family inet.Sn 

Internet Transmission Control .... tcp.Sn 

Internet User Datagram udp.Sn 

interpolate smooth curve spline.lg 

interpret ASA carriage control .... asa. I 
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sno: SNOBOL 

syntax, csh: a shell (command 

pipe: create an 

facilities/ ipcs: report 

package, stdipc: standard 

suspend execution for an 

sleep: suspend execution for 

commands and application/ 

formats. 

miscellany. 

files. 

subroutines and libraries. 

calls and error numbers. 

maintenance commands and/ 

maintenance procedures. 

application programs, intro: 

intro: 

intro: 

intro: 

facilities, net: 

intro: 

and libraries, intro: 

and error numbers, intro: 

maintenance commands/ intro: 

maintenance/ intro: 

ncheck: generate names from 

aliens: The alien 

select: synchronous 

abort: generate an 

semaphore set or shared/ 

communication facilities/ 

/islower, isdigit, isxdigit, 

isdigit, isxdigit, isalnum,/ 

/isprint, isgraph, iscntrl, 

terminal, ttyname, 

/ispunct, isprint, isgraph, 

isalpha, isupper, islower, 

/isspace, ispunct, isprint, 

isalnum,/ isalpha, isupper, 

/isalnum, isspace, ispunct, 

/isxdigit, isalnum, isspace, 

/isdigit, isxdigit, isalnum, 

system: 

issue: 

file. 

isxdigit, isalnum,/ isalpha, 

/isupper, islower, isdigit, 

news: print news 

functions. 

functions. jO, 

bj: the game of black 

functions. jO, jl, 

operator. 

/Irand48, nrand48, mrand48, 

makekey: generate encryption 

killall: 

process or a group of/ 

processes. 

chase: Try to escape the 

mem. 



interpreter sno.l 

interpreter) with C-like csh.l 

interprocess channel pipe.2 

inter-process communication .... ipcs.l 

interprocess communication stdipc.3c 

interval, sleep: sleep. 1 

interval sleep.Sc 

intro: introduction to intro. 1 

intro: introduction to file intro.4 

intro: introduction to games intro.6 

intro: introduction to intro.5 

intro: introduction to special intro.7 

intro: introduction to intro.3 

intro: introduction to system .... intro.2 

intro: introduction to system .... intro. Im 

intro: introduction to system .... intro.8 

introduction to commands and . . . intro. 1 

introduction to file formats intro.4 

introduction to games intro.6 

introduction to miscellany intro.5 

introduction to networking net.5n 

introduction to special files intro.7 

introduction to subroutines intro.3 

introduction to system calls intro.2 

introduction to system intro. Im 

introduction to system intro.8 

i-numbers ncheck.lm 

invaders attack the earth aliens.6 

i/o multiplexing select.2n 

ioctl: control device ioctl.2 

lOT fault abort.3c 

ip: Internet Protocol ip.5n 

ipcrm: remove a message queue, . . . ipcrm.l 

ipcs: report inter-process ipcs.l 

isalnum, isspace, ispunct,/ ctype.3c 

isalpha, isupper, islower, ctype.3c 

isascii: classify characters ctype.3c 

isatty: find name of a ttyname.3c 

iscntrl, isascii: classify/ clype.3c 

isdigit, isxdigit, isalnum,/ ctype.3c 

isgraph, iscntrl, isascii:/ ctype.3c 

islower, isdigit, isxdigit, ctype.3c 

isprint, isgraph, iscntrl,/ ctype.3c 

ispunct, isprint, isgraph,/ ctype.3c 

isspace, ispunct, isprint,/ ctype.3c 

issue a shell command system.3s 

issue identification file issue.4 

issue: issue identification issue.4 

isupper, islower, isdigit, ctype.3c 

isxdigit, isalnum, isspace,/ ctype.3c 

items news.l 

jO, jl, jn, yO, yl, yn: Bessel bessel.3m 

jl, jn, yO, yl, yn: Bessel bessel.3m 

jack bj.6 

jn, yO, yl, yn: Bessel bessel.3m 

join: relational database join.l 

jrand48, srand48, seed48,/ drand48.3c 

key makekey.l 

kill all active processes killall. Im 

kill: send a signal to a kill.2 

kill: terminate a process kill.l 

killall: kill all active killall. Im 

killer robots chase.6 

kmem: core memory mem. 7 



19 



Permuted Index 



quiz: test your 

3-byte integers and long/ 

integer and base-64/ a641, 

copy file systems with 

with label checking, volcopy, 

scanning and processing 

arbitrary-precision arithmetic 

efl: Extended Fortran 

command programming 

cpp: the C 

chargefee, ckpacct, dodisk, 

/jrand48, srand48, seed48, 

of floating-point/ frexp, 

getopt: get option 

simple lexical tasks. 

generate programs for simple 

to subroutines and 

relation for an object 

ar: archive 

ar: archive and 

ulimit: get and set user 

line: read one 

an out-going terminal 

type, modes, speed, and 

nl: 

out selected fields of each 

send/ cancel requests to an LP 

Ipr: 

Isearch: 

col: filter reverse 

head: give first few 

files, comm: select or reject 

uniq: report repeated 

of several files or subsequent 

subsequent/ paste: merge same 

link, unlink: exercise 

Id: 

a.out: assembler and 

cp. In, mv: copy, 

link: 

and unlink system calls. 

nlist: get entries from name 

nm: print name 

Is: 

(Berkeley version). Is7: 

for a file system, ff: 

by fsck. checklist: 

xargs: construct argument 

files, cp, 

tzset: convert date/ ctime, 

end, etext, edata: last 

memory, plock: 

regions for reading or/ 

gamma: 

newgrp: 

exponential, logarithm,/ exp, 

logarithm, power,/ exp, log, 

/loglO, pow, sqrt: exponential, 

errpt: process a report of 

rwho: who is 



knowledge quiz.6 

13tol, ltol3: convert between 13tol.3c 

164a: convert between long h641.3c 

label checking, /labelit: volcopy.lm 

labelit: copy file systems volcopy.lm 

language, awk: pattern awk.l 

language, be: bc.l 

Language efl.l 

language, /standard/ restricted . . . . sh.l 

language preprocessor cpp.l 

lastlogin, monacct, nulladm,/ .... acctsh.im 

lcong48: generate uniformly/ .... drand48.3c 

Id: link editor Id.l 

Idexp, modf: manipulate parts .... frexp.3c 

letter from argument vector getopt.3c 

lex: generate programs for lex.l 

lexical tasks, lex: lex.l 

libraries, /introduction intro.3 

library, /find ordering lorder.l 

(library) file format ar.4 

library maintainer ar.l 

limits ulimit.2 

line line.l 

line connection, /establish dial.3c 

line discipline, /set terminal getty.lm 

line numbering filter nl.l 

line of a file, cut: cut cut.l 

line printer. Ip, cancel: Ip.l 

line printer spooler Ipr.l 

line: read one line line. 1 

linear search and update lsearch.3c 

line-feeds col.l 

lines head.l 

lines common to two sorted comm.l 

lines in a file uniq.l 

lines of one file, /same lines .... paste. 1 

lines of several files or paste. 1 

link and unlink system calls link.lm 

link editor Id.l 

link editor output a.out.4 

link: link to a file link.2 

link or move files cp.l 

link to a file link.2 

link, unlink: exercise link link.lm 

lint: a C program checker lint.l 

list nlist.3c 

list nm.l 

list contents of directories Is.l 

list contents of directory Is7.1 

list file names and statistics ff.lm 

list of file systems processed checklist.4 

list(s) and execute command xargs. 1 

In, mv: copy, link or move cp.l 

localtime, gmtime, asctime, ctime.3c 

locations in program end.3c 

lock process, text, or data in .... plock.2 

lockf: provide exclusive file lockf.2 

log gamma function gamma.3m 

log in to a new group newgrp. 1 

log, loglO, pow, sqrt: exp.3m 

log 10, pow, sqrt: exponential, .... exp.3m 

logarithm, power, square root/ . . . exp.3m 

logged errors errpt. Im 

logged in on local machines rwho. In 
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riogin: remote 

getlogin: get 

logname: get 

cuserid: get character 

logname: return 

passwd: change 

setting up an environment at 

user. 

a641, 164a: convert between 

between 3-byte integers and 

sputl, sgetl: access 

setjmp, 

interface. 

loop: software 

for an object library. 

mklost+ found: make a 

nice: run a command at 

requests to an LP line/ 

send/ cancel requests to an 

disable: enable/ disable 

/Ipshut, Ipmove: start/ stop the 

accept, reject: allow/prevent 

Ipadmin: configure the 

Ipstat: print 

spooling system. 

request/ Ipsched, Ipshut, 

start/ stop the LP request/ 

LP request scheduler/ Ipsched, 

information. 

jrand48,/ drand48, erand48, 

directories. 

directory (Berkeley version). 

update. 

pointer. 

integers and long/ 13tol, 

truth value about your/ 

put: puts a file onto a remote 

puts a file onto a remote 

takes a file from a remote 

takes a file from a remote 

/access long numeric data in a 

show host status of local 

who is logged in on local 

update files between two 

update files between two 

permuted index, mptx: the 

documents, mm: the MM 

mosd: the OSDD adapter 

view graphs and/ mv: a troff 

m4: 

formatted with the MM 

in this manual, man: 

tp: 

send mail to users or read 

users or read mail. 

netmail: the bnet network 

netmailer: deliver 

delivermail: deliver 

mail, rmail: send 

malloc, free, realloc, calloc: 



login rlogin.ln 

login name getlogin.3c 

login name logname. 1 

login name of the user cuserid.3s 

login name of user logname.Sx 

login password passwd. 1 

login: sign on login. 1 

login time, profile: profile.4 

logname: get login name logname. 1 

logname: return login name of ... . logname.3x 

long integer and base-64 ASCII/ . . . h641.3c 

long integers. /ltol3: convert .... 13tol.3c 

long numeric data in a machine/ . . . sputl.3x 

longjmp: non-local goto setjmp.3c 

loop: software loopback lo.Sn 

loopback interface lo.Sn 

lorder: find ordering relation .... lorder.l 

lost 4- found directory for fsck mklost+fnd.lm 

low priority nice.l 

Ip, cancel: send/ cancel Ip.l 

LP line printer. Ip, cancel: Ip.l 

LP printers, enable, enable.! 

LP request scheduler and move/ . . . Ipsched. Im 

LP requests accept.lm 

LP spooling system Ipadmin. Im 

LP status information Ipstat. 1 

Ipadmin: configure the LP Ipadmin. Im 

Ipmove: start/ stop the LP Ipsched. Im 

Ipr: line printer spooler. Ipr.l 

Ipsched, Ipshut, Ipmove: Ipsched. Im 

Ipshut, Ipmove: start/ stop the .... Ipsched.lm 

Ipstat: print LP status Ipstat. 1 

lrand48, nrand48, mrand48, drand48.3c 

Is: list contents of Is. 1 

ls7: list contents of Is7.1 

Isearch: linear search and lsearch.3c 

Iseek: move read/write file lseek.2 

ltol3: convert between 3-byte .... 13toI.3c 

m4: macro processor m4.1 

m68k, pdpll, u3b, vax: provide . . . machid.l 

machine put.lc 

machine.. put7: putT.lc 

machine, take: take.lc 

machine.. takeV: take7.1c 

machine independent fashion sputl.3x 

machines, ruptime: ruptime.ln 

machines, rwho: rwho.ln 

machines, updater: updater.l 

machines, updater: updater. Itn 

macro package for formatting a ... mptx.5 

macro package for formatting .... mm.5 

macro package for formatting/ .... mosd.S 

macro package for typesetting .... mv.5 

macro processor m4.1 

macros, /print/ check documents . . . mm.l 

macros for formatting entries .... man. 5 

magnetic tape format tp.4 

mail, mail, rmail: mail.l 

mail, rmail: send mail to mail.l 

mail system netmailSn 

mail to netmailer.Sn 

mail to arbitrary people delivermail.Sn 

mail to users or read mail mail.l 

main memory allocator malloc.3c 
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program, ctags: 

regenerate groups of/ make: 

ar: archive and library 

intro: introduction to system 

intro: introduction to system 

sees file, delta: 

mkdir: 

or ordinary file, mknod: 

for fsck. mklostH- found: 

mktemp: 

regenerate groups of/ 

ssp: 

banner: 

key. 

main memory allocator. 

entries in this manual. 

this manual. 

tsearch, tdelete, twalk: 

hsearch, hcreate, hdestroy: 

records, fwtmp, wtmpfix: 

frexp, Idexp, modf: 

tp: 

manual, man, 

manprog: print entries in this 

for formatting entries in this 

ascii: 

files, diffmk: 

umask: set file-creation mode 

set and get file creation 

an error message file by 

table, master: 

information table. 

regular expression compile and 

eqn, neqn, checkeq: format 

function. 

maze: generate a 

bed: convert to antique 

memcpy, memset: memory/ 

memset: memory/ memccpy, 

operations, memccpy, memchr, 

memccpy, memchr, memcmp, 

mem, kmem: core 

lock process, text, or data in 

free, realloc, calloc: main 

shmctl: shared 

queue, semaphore set or shared 

memcmp, memcpy, memset: 

shmop: shared 

shmget: get shared 

/memchr, memcmp, memcpy, 

sort: sort and/ or 

files, acctmerg: 

files or subsequent/ paste: 

msgctl: 

mkstr: create an error 

receive: receive 

send: send 

msgop: 

msgget: get 

or shared/ ipcrm: remove a 

mesg: permit or deny 



maintain a tags file for a e ctags. 1 

maintain, update, and make.l 

maintainer ar.l 

maintenance commands and/ .... intro. Im 

maintenance procedures intro.8 

make a delta (change) to an delta. 1 

make a directory mkdir. 1 

make a directory, or a special .... mknod.2 
make a lost + found directory .... mklost+fnd.lm 

make a unique file name mktemp.3c 

make: maintain, update, and .... make.l 

make output single spaced ssp.l 

make posters banner. 1 

makekey: generate encryption .... makekey.l 

malloc, free, realloc, calloc: malloc.3c 

man: macros for formatting man.5 

man, manprog: print entries in .... man.l 

manage binary search trees tsearch.3c 

manage hash search tables hsearch.3c 

manipulate connect accounting ; . . . fwtmp. Im 

manipulate parts of/ frexp.3c 

manipulate tape archive tp.l 

manprog: print entries in this .... man. 1 

manual, man, man.l 

manual, man: macros man.5 

map of ASeil character set ascii.5 

mark differences between diffmk. 1 

mask umask.l 

mask, umask: umask.2 

massaging e source, /create ..... mkstr.l 

master device information master.4 

master: master device master.4 

match routines, regexp: regexp.5 

mathematical text for nroff or/ ... eqn.l 

matherr: error-handling matherr.3m 

maze maze.6 

maze: generate a maze maze.6 

media bcd.6 

mem, kmem: core memory mem. 7 

memccpy, memchr, memcmp, .... memory.3c 
memchr, memcmp, memcpy, .... memory.3c 
memcmp, memcpy, memset: memory memory.3c 

memcpy, memset: memory/ memory.3c 

memory mem. 7 

memory, plock: plock.2 

memory allocator, malloc, malloc.3c 

memory control operations shmctl.2 

memory id. /remove a message . . . ipcrm. 1 
memory operations, /memchr, . . . memory.3c 

memory operations shmop.2 

memory segment. shmget.2 

memset: memory operations memory.3c 

merge files sort.l 

merge or add total accounting .... acctmerg. Im 

merge same lines of several paste. 1 

mesg: permit or deny messages. . . . mesg.l 

message control operations msgctl.2 

message file by massaging C/ .... mkstr.l 

message from a socket receive.2n 

message from a socket send.2 

message operations. msgop.2 

message queue msgget.2 

message queue, semaphore set ... ipcrm. 1 
messages mesg.l 
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sys_nerr: system error 



system, 
lost + found directory for/ 

special or ordinary file. 

file by massaging C source. 

name. 

formatting documents, mm: the 

documents formatted with the 

documents formatted with the/ 

formatting documents. 

view graphs, and slides. 

table. 

chmod: change 

umask: set file-creation 

chmod: change 

getty: set terminal type, 

bs: a compiler/ interpreter for 

floating-point/ frexp, Idexp, 

utime: set file access and 

touch: update access and 

/ckpacct, dodisk, lastlogin, 

profile. 

uusub: 

package for formatting/ 

/ASCII formats suitable for 

rcvhex: translates 

mount: 

system, mount, umount: 

setmnt: establish 

dismount file system. 

mnttab: 

mvdir: 

cp. In, mv: copy, link or 

Iseek: 

the LP request scheduler and 

formatting a permuted index. 

/erand48, lrand48, nrand48, 

operations. 



select: synchronous i/o 

typesetting view graphs and/ 

cp. In, 

graphs, and slides, mmt, 

i-numbers. 

definitions for eqn and 

mathematical text for/ eqn, 

networking facilities. 

system. 

uusub: monitor uucp 

netmail: the bnet 

rstat: 

net: introduction to 

a text file. 

news: print 



messages, /errno, sys_errlist, .... perror.3c 

mkdir: make a directory mkdir.l 

mkfs: construct a file system mkfs.lm 

mkfslb: construct a file mkfslb.lm 

mklost+ found: make a mklost-l-fnd.lm 

mknod: build special file mknod.lm 

mknod: make a directory, or a ... . mknod.2 

mkstr: create an error message . . . mkstr.l 

mktemp: make a unique file mktemp.3c 

MM macro package for mm. 5 

MM macros, /print/check mm.l 

mm, osdd, checkmm: print/check . . mm.l 

mm: the MM macro package for . . . mm.5 

mmt, mvt: typeset documents, . . . mmt.l 

mnttab: mounted file system .... mnttab.4 

mode chmod. 1 

mode mask umask. 1 

mode of file chmod.2 

modes, speed, and line/ getty. Im 

modest-sized programs bs.l 

modf: manipulate parts of frexp.3c 

modification times utime.2 

modification times of a file touch. 1 

monacct, nulladm, prctmp,/ acctsh.lm 

monitor: prepare execution monitor.Sc 

monitor uucp network uusub. Im 

moo: guessing game moo.6 

mosd: the OSDD adapter macro . . . mosd.5 

Motorola S-record downloading. . . . hex.l 

Motorola S-records from/ rcvhex. 1 

mount a file system mount.2 

mount and dismount file mount. Im 

mount: mount a file system mount.2 

mount table setmnt.lm 

mount, umount: mount and mountlm 

mounted file system table mnttab.4 

move a directory mvdir. Im 

move files cp. 1 

move read/write file pointer Iseek. 2 

move requests, /start/stop Ipsched.lm 

mptx: the macro package for .... mptx.5 

mrand48, jrand48, srand48,/ .... drand48.3c 

msgctl: message control msgctl.2 

msgget: get message queue msgget.2 

msgop: message operations msgop.2 

multiplexing select.2n 

mv: a trofi" macro package for .... mv.5 

mv: copy, link or move files cp.l 

mvdir: move a directory mvdir. Im 

mvt: typeset documents, view .... mmt.l 

ncheck: generate names from .... ncheck.lm 

neqn. /special character eqnchar.5 

neqn, checkeq: format eqn.l 

net: introduction to net.Sn 

netmail: the bnet network mail . . . netmail.8n 

netmailer: deliver mail to netmailer.Sn 

network uusub.lm 

network mail system netmail.8n 

network statistics program rstat. In 

networking facilities net.Sn 

newform: change the format of ... newform.l 

newgrp: log in to a new group newgrp.l 

news items news.l 

news: print news items news.l 
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process, 
priority. 



list. 



hangups {sh only). 

setjmp, longjmp: 

drand48, erand48, lrand48, 

format mathematical text for 

tbl: format tables for 

typesetting. 

constructs, deroff: remove 

null; the 

/dodisk, lastlogin, monacct, 

nl: line 

number: convert Arabic 

sputl, sgetl: access long 

size: size of an 

formats/ hex: translates 

find ordering relation for an 

/the printable strings in an 

od: 

immune to hangups {sh 

the specified/ exterr - turn 

put: puts a file 

put7: puts a file 

fopen, freopen, fdopen: 

dup: duplicate an 

open: 

writing. 

/prfdc, prfsnap, prfpr: 

tputs: terminal independent 

memcmp, memcpy, memset: memory 

msgctl: message control 

msgop: message 

semctl: semaphore control 

semop: semaphore 

shmctl: shared memory control 

shmop: shared memory 

strcspn, strtok: string 

join: relational database 

dcopy: copy file systems for 

vector, getopt: get 

fcntl: file control 

getopt: parse command 

object library, lorder: find 

a directory, or a special or 

editor based/ vi, view: screen 

formatting/ mosd: the 

documents formatted with/ mm, 

dial: establish an 

assembler and link editor 

sprintf: print formatted 

ssp: make 

/acctdusg, accton, acctwtmp: 

chown: change 

chown, chgrp: change 

and expand files. 

sadc: system activity report 

standard buffered input/output 

interprocess communication 



nice: change priority of a nice.2 

nice: run a command at low nice.l 

nl: line numbering filter nl.l 

nlist: get entries from name nlist.3c 

nm: print name list nm.l 

nohup: run a command immune to . nohup.l 

non-local goto setjmp.3c 

nrand48, mrand48, jrand48,/ .... drand48.3c 

nroff: format text nroff.l 

nroff or troff. /checkeq: eqn.l 

nroff or troff tbl.l 

nroff?: text formatting and nroff?. 1 

nroff/ troff, tbl, and eqn deroff. 1 

null file null.? 

null: the null file null.? 

nuUadm, prctmp, prdaily,/ acctsh.lm 

numbering filter. nl.l 

numerals to English number.6 

numeric data in a machine/ sputl.Sx 

object file size.l 

object files into ASCII hex.l 

object library, lorder: lorder. 1 

object, or other binary file strings. 1 

octal dump od.l 

od: octal dump od.l 

only), nohup: run a command .... nohup.l 

on/ off the extended errors in .... exterr. 1 

onto a remote machine put.lc 

onto a remote machine put?.lc 

open a stream fopen.3s 

open file descriptor dup.2 

open for reading or writing open.2 

open: open for reading or open.2 

operating system profiler profiler.! m 

operation routines, /tgoto, termcap.3 

operations, memccpy, memchr, . . . memory.3c 

operations msgctl.2 

operations msgop.2 

operations semctl.2 

operations semop.2 

operations. shmctl.2 

operations shmop.2 

operations, /strpbrk, strspn, string.3c 

operator join.l 

optimal access time dcopy. Im 

option letter from argument ..... getopt.3c 

options fcntl.5 

options getopt.1 

ordering relation for an lorder. 1 

ordinary file, mknod: make mknod.2 

oriented (visual) display vi.l 

OSDD adapter macro package for . . mosd.5 

osdd, checkmm: print/check mm.l 

out-going terminal line/ dial.3c 

output, a.out: a.out.4 

output, printf, fprintf, printf.3s 

output single spaced ssp.l 

overview of accounting and/ .... acct.lm 

owner and group of a file chown.2 

owner or group chown. 1 

pack, peat, unpack: compress .... pack.l 

package, sal, sa2 sar.lm 

package, stdio: stdio.3s 

package, stdipc: standard stdipc.3c 
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permuted/ mptx: the macro 

documents, mm: the MM macro 

mosd: the OSDD adapter macro 

graphs and/ mv: a troff macro 

4014 terminal. 4014: 

tune floppy disk settling time 

process, process group, and 

getopt: 



getpass: read a 

passwd: change login 

passwd: 

/setpwent, endpwent: get 

putpwent: write 

pwck, grpck: 

several files or subsequent/ 

dirname: deliver portions of 

directory, getcwd: get 

fgrep: search a file for a 

processing language, awk: 

signal. 

expand files, pack, 

a process, popen, 

value about your/ m68k, 

mesg: 

macro package for formatting a 

ptx: 

format, acct: 

acctcms: command summary from 

sys_nerr: system error/ 

viewing, more: file 

tc: 

access physical addresses. 

allow a process to access 

split: split a file into 

channel. 

tee: 

popen, pclose: initiate 

fish: 

life: 

worm: 

data in memory. 

subroutines. 

images. 

Iseek: move read/write file 

ftell: reposition a file 

to/ from a process. 

data base of terminal types by 

basename, dirname: deliver 

banner: make 

logarithm,/ exp, log, loglO, 

/sqrt: exponential, logarithm, 

brc, bcheckrc, re, 

/lastlogin, monacct, nulladm, 

/monacct, nulladm, prctmp, 

for troff. cw, checkcw: 

monitor: 

cpp: the C language 

unget: undo a 

operating/ prfld, prfstat, 

prfsnap, prfpr: operating/ 



package for formatting a mptx.S 

package for formatting mm. 5 

package for formatting/ mosd.5 

package for typesetting view mv.5 

paginator for the Tektronix 4014.1 

parameters, disktune - disktune.lm 

parent process IDs. /get getpid.2 

parse command options getopt. 1 

passwd: change login password. . . . passwd. 1 

passwd: password file passwd.4 

password getpass.3c 

password passwd.l 

password file passwd.4 

password file entry getpwent.3c 

password file entry putpwent.Sc 

password/ group file checkers pwck.lm 

paste: merge same lines of paste. 1 

path names, basename, basename. 1 

pathname of current working .... getcwd.3c 

pattern, grep, egrep, ........ grep.l 

pattern scanning and awk.l 

pause: suspend process until pause.2 

peat, unpack: compress and pack.l 

pclose: initiate pipe to/from popen.Ss 

pdpll, u3b, vax: provide truth .... machid.l 

permit or deny messages mesg.l 

permuted index, mptx: the mptx.S 

permuted index ptx.l 

per-process accounting file acct.4 

per-process accounting/ acctcms. Im 

perror, errno, sys_errlist, perror.3c 

perusal filter for crt more. 1 

phototypesetter simulator tc.l 

phys: allow a process to phys.2 

physical addresses, phys: phys.2 

pieces split. 1 

pipe: create an interprocess pipe.2 

pipe fitting tee.l 

pipe to/from a process popen.3s 

play "Go Fish" fish.6 

play the game of life life.6 

Play the growing worm game worm.6 

plock: lock process, text, or plock.2 

plot: graphics interface plot.4 

plot: graphics interface plot.3x 

pnch: file format for card pnch.4 

pointer lseek.2 

pointer in a stream, /rewind, .... fseek.3s 

popen, pclose: initiate pipe popen.3s 

port, ttytype: ttytype.4 

portions of path names basename. 1 

posters banner.l 

pow, sqrt: exponential, exp.3m 

power, square root functions exp.3m 

powerfail: system/ brc.lm 

pr: print files pr.l 

prctmp, prdaily, prtacct,/ acctsh.lm 

prdaily, prtacct, runacct,/ acctsh.lm 

prepare constant- width text cw.l 

prepare execution profile monitor.3c 

preprocessor cpp.l 

previous get of an sees file unget. 1 

prfdc, prfsnap, prfpr: profiler.lm 

prfld, prfstat, prfdc, profiler.lm 
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/prfstat, prfdc, prfsnap, 

system/ prfld, prfstat, prfdc, 

prfpr: operating/ prfld, 

graphical/ gps: graphical 

types: 

interesting, adage, fortune: 

prs: 

date: 

cal: 

of a file, sum: 

editing activity, sact: 

man, manprog: 

cat: concatenate and 

pr: 

printf, fprintf, sprintf: 

banner?: 

Ipstat: 

nm: 

system, hostname: set or 

System, uname: 

news: 

printenv: 

file(s). acctcom: search and 

pstat: 

names, id: 

object, or/ strings: find the 

formatted/ mm, osdd, checkmm: 

environment. 

banner?: print large banner on 

requests to an LP line 

Ipr: line 

disable: enable/ disable LP 

print formatted output. 

nice: run a command at low 

nice: change 

exit, _exit: terminate 

fork: create a new 

inittab: script for the init 

kill: terminate a 

nice: change priority of a 

initiate pipe to/from a 

wait: await completion of 

errors, errpt: 

acct: enable or disable 

acctprcl, acctprc2: 

acctcom: search and print 

times, times: get 

init, telinit: 

timex: time a command; report 

/getpgrp, getppid: get process, 

setpgrp: set 

process group, and parent 

kill: send a signal to a 

getpid, getpgrp, getppid: get 

ps: report 

memory, plock: lock 

times: get process and child 

addresses, phys: allow a 

wait: wait for child 

ptrace: 

pause: suspend 

list of file systems 

to a process or a group of 

kiilall: kill all active 



prfpr: operating system/ profiler. Im 

prfsnap, prfpr: operating profiler. Im 

prfstat, prfdc, prfsnap, profiler. Im 

primitive string, format of gps.4 

primitive system data types types.5 

print a random, hopefully fortune.6 

print an sees file prs.l 

print and set the date date.l 

print calendar. . cal.l 

print checksum and block count . . . sum.l 

print current SCCS file sact. 1 

print entries in this manual man.l 

print files cat. 1 

print files pr.l 

print formatted output printf.3s 

print large banner on printer banner?.! 

print LP status information Ipstat. 1 

print name list nm.l 

print name of current host hostname.ln 

print name of current UNIX uname.l 

print news items news.l 

print out the environment printenv. 1 

print process accounting acctcom. 1 

print system facts pstat. Im 

print user and group IDs and .... id. 1 

printable strings in an strings. 1 

print/check documents mm.l 

printenv: print out the printenv.l 

printer banner?.! 

printer, /cancel: send/ cancel . . . . Ip.l 

printer spooler Ipr.l 

printers, enable, enable. 1 

printf, fprintf, sprintf: printf.3s 

priority nice.l 

priority of a process nice.2 

process exit.2 

process fork.2 

process inittab.4 

process kill.l 

process nice.2 

process, popen, pclose: popen.3s 

process wait.l 

process a report of logged errpt. Im 

process accounting acct.2 

process accounting acctprcl m 

process accounting file(s) acctcom.l 

process and child process times.2 

process control/ init.lm 

process data and system/ timex. 1 

process group, and parent/ getpid.2 

process group ID setpgrp. 2 

process IDs. /get process, getpid.2 

process or a group of/ kill.2 

process, process group, and/ .... getpid.2 

process status ps.l 

process, text, or data in plock.2 

process times times.2 

process to access physical phys.2 

process to stop or terminate wait.2 

process trace. ptrace.2 

process until signal pause.2 

processed by fsck. checklist: checklist.4 

processes, /send a signal kill.2 

processes kiilall. Im 
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structure, fuser: identify 

shutdown: terminate all 

awk: pattern scanning and 

m4: macro 

provide truth value about your 

alarm: set a 

profile. 

monitor: prepare execution 

profil: execution time 

prof: display 

environment at login time. 

prfpr: operating system 

sadp: disk access 

standard/restricted command 

ip: Internet 

Internet Transmission Control 

udp: Internet User Datagram 

inet: Internet 

arithmetic: 

for reading or/ lockf: 

m68k, pdpll, u3b, vax: 

true, false: 

/nulladm, prctmp, prdaily, 

/generate uniformly distributed 



stream, ungetc: 

remote machine.. 

put character or word on a/ 

character or word on a/ putc, 

entry. 

machine., put: 

machine.. put7: 

stream. 

getutent, getutid, getutline, 

a/ putc, putchar, fputc, 

file checkers. 



msgget: get message 

ipcrm: remove a message 

qsort: 

by name or address, rhost, 

display. 

rain: animated 

random-number generator. 

adage, fortune: print a 

rand, stand: simple 

fsplit: split fortran, 

initialization/ brc, bcheckrc, 

S-records from downloading/ 

getpass: 

read: 

rmail: send mail to users or 

line: 

exclusive file regions for 
open: open for 



processes using a file or file fuser. Im 

processing shutdown. Im 

processing language awk.i 

processor m4.1 

processor type. /u3b, vax: machid.l 

process's alarm clock alarm. 2 

prof: display profile data prof.l 

profil: execution time profil.2 

profile monitor.3c 

profile profil.2 

profile data prof.l 

profile: setting up an profile.4 

profiler, /prfdc, prfsnap, profiler. Im 

profiler sadp. I 

programming language, /the . . . . sh.l 

Protocol ip.5n 

Protocol, tcp: tcp.Sn 

Protocol udp.5n 

protocol family inet.Sn 

provide drill in number facts arithmetic.6 

provide exclusive file regions .... Iockf.2 

provide truth value about your/ . . . machid.l 

provide truth values true.l 

prs: print an SCCS file prs. 1 

prtacct, runacct, shutacct,/ acctsh.lm 

ps: report process status ps. 1 

pseudo-random numbers drand48.3c 

pstat: print system facts pstat.Im 

ptrace: process trace ptrace.2 

ptx: permuted index ptx.l 

push character back into input .... ungetc.3s 

put7: puts a file onto a put7.lc 

putc, putchar, fputc, putw: putc.3s 

putchar, fputc, putw: put putc.3s 

putpwent: write password file .... putpwent.3c 

puts a file onto a remote put.lc 

puts a file onto a remote putT.lc 

puts, fputs: put a string on a puts.3s 

pututline, setutent, endutent,/ .... getut.3c 

putw: put character or word on ... putc.3s 

pwck, grpck: password/group .... pwck.lm 

pwd: working directory name pwd.l 

qsort: quicker sort. qsort.3c 

queue msgget.2 

queue, semaphore set or shared/ . . ipcrm. 1 

quicker sort qsort.3c 

quiz: test your knowledge quiz.6 

raddr: look up internet hosts .... rhost.3n 

rain: animated raindrops rain.6 

raindrops display. rain.6 

rand, srand: simple rand.3c 

random, hopefully interesting, .... fortune.6 

random-number generator rand.3c 

ratfor, or efl files fsplit. 1 

re, powerfail: system brc.lm 

rep: remote file copy rep. In 

rcvhex: translates Motorola rcvhex.l 

read a password getpass.3c 

read from file read.2 

read mail, mail, mail.l 

read one line line.l 

read: read from file read.2 

reading or writing, /provide lockf.2 

reading or writing open.2 
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Iseek: move 
allocator, malloc, free, 

reboot: 

specify what to do upon 

receive: 

a socket. 

from per-process accounting 

manipulate connect accounting 

errdead: extract error 

tape, free: 

ed, 

generate C program cross 

execute regular expression. 

compile. 

make: maintain, update, and 

regular expression, regcmp, 

compile and match routines. 

lockf: provide exclusive file 

regex: compile and execute 

regcmp: 

match routines, regexp: 

requests, accept, 

sorted files, comm: select or 

lorder: find ordering 

join: 

strip: remove symbols and 

/fmod, fabs: floor, ceiling, 

calendar: 

rep: 

rlogin: 

put: puts a file onto a 

put?: puts a file onto a 

take: takes a file from a 

take?: takes a file from a 

remsh: 

ct: spawn getty to a 

file, rmdel: 

semaphore set or/ ipcrm: 

unlink: 

rm, rmdir: 

eqn constructs, deroff: 

bits, strip: 

check and interactive 

uniq: report 

clock: 

communication/ ipcs: 

blocks, df: 

errpt: process a 

frequencies in a file, freq: 

sa2, sadc: system activity 

timex: time a command; 

ps: 

file, uniq: 

sar: system activity 

files, version: 

stream, fseek, rewind, ftell: 

/Ipmove: start/stop the LP 

reject: allow/ prevent LP 

LP request scheduler and move 

Ip, cancel: send/ cancel 

teletype bits to a/ tset, 

sensible/ tset, reset: set or 



read/write file pointer lseek.2 

realloc, calloc: main memory .... malloc.3c 

reboot: reboot the system reboot.2 

reboot the system reboot.2 

receipt of a signal, signal: signal.2 

receive message from a socket. . . . receive.2n 

receive: receive message from .... receive.2n 

records, /command summary .... acctcms.lm 

records, fwtmp, wtmpfix: fwtmp.lm 

records from dump errdead. 1 m 

recover files from a backup frec.lm 

red: text editor ed.l 

reference, cxref: cxref.l 

regcmp, regex: compile and regcmp.3x 

regcmp: regular expression regcmp. 1 

regenerate groups of programs. . . . make. 1 

regex: compile and execute regcmp.3x 

regexp: regular expression regexp.5 

regions for reading or/ lockf.2 

regular expression, regcmp, regcmp.3x 

regular expression compile regcmp. 1 

regular expression compile and . . . regexp.S 

reject: allow/prevent LP accept. 1 m 

reject lines common to two comm.l 

relation for an object/ lorder. 1 

relational database operator join.l 

relocation bits strip. 1 

remainder, absolute value/ floor.3m 

reminder service calendar.! 

remote file copy rep. 1 n 

remote login rlogin. In 

remote machine put.lc 

remote machine put?.lc 

remote machine take.lc 

remote machine take?.lc 

remote shell remsh. In 

remote terminal ct.lc 

remove a delta from an sees .... rmdel. 1 

remove a message queue, ipcrm. 1 

remove directory entry unlink.2 

remove files or directories rm.l 

remove nroff/troff, tbl, and deroff. 1 

remove symbols and relocation . . . strip. 1 

remsh: remote shell remsh. In 

repair, /system consistency fsck.lm 

repeated lines in a file uniq.l 

report CPU time used clock.3c 

report inter-process ipcs.l 

report number of free disk df.lm 

report of logged errors errpt. Im 

report on character freq.l 

report package, sal, sar.lm 

report process data and system/ . . . timex. 1 

report process status ps. 1 

report repeated lines in a uniq.l 

reporter sar.l 

reports version number of version. 1 

reposition a file pointer in a fseek.3s 

request scheduler and move/ .... Ipsched. 1 m 

requests, accept, accept. Im 

requests, /start/stop the Ipsched. I m 

requests to an LP line/ Ip. 1 

reset: set or reset the tset. 1 

reset the teletype bits to a tset. 1 
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a socket, socketaddr: 

abs: 

logname: 

name, getenv: 

Stat: data 

configuration/ uvar: 

col: filter 

file pointer in a/ fseek, 

creat: create a new file or 

hosts by name or address. 

directories. 

read mail, mail, 

sees file. 

directories, rm, 

Escape from the automatic 

Try to escape the killer 

robots: Escape from the 

robots. 

chroot: change 

chroot: change 

logarithm, power, square 

expression compile and match 

terminal independent operation 

standard/restricted/ sh, 

program. 

nice: 

hangups (sh/ nohup: 

runacct: 

/prctmp, prdaily, prtacct, 

local machines. 

local machines. 

activity report package. 

report package, sal, 

editing activity. 

package, sal, sa2. 



space allocation, brk, 

formatted input. 

bfs: big file 

language, awk: pattern 

the delta commentary of an 

comb: combine 

make a delta (change) to an 

get: get a version of an 

prs: print an 

rmdel: remove a delta from an 

compare two versions of an 

sccsfile: format of 

undo a previous get of an 

val: validate 

sact: print current 

admin: create and administer 

what: identify 

of an sees file. 

/start/stop the LP request 

clear: clear terminal 

twinkle: twinkle stars on the 

display editor/ vi, view: 

inittab: 



return address associated with .... socketaddr.2n 

return integer absolute value abs.3c 

return login name of user logname.3x 

return value for environment .... getenv.3c 

returned by stat system call stat.5 

returns system-specific uvar.2 

reverse line- feeds col.l 

rewind, ftell: reposition a fseek.Ss 

rewrite an existing one creat.2 

rhost, raddr: look up internet .... rhost.3n 

rlogin: remote login rlogin.ln 

rm, rmdir: remove files or rm.l 

rmail: send mail to users or mail.l 

rmdel: remove a delta from an ... rmdel. 1 

rmdir: remove files or rm.l 

robots, autorobots: autorobots.6 

robots, chase: chase.6 

robots robots.6 

robots: Escape from the robots.6 

root directory chroot.2 

root directory for a command chroot. Im 

root functions, /exponential, .... exp.3m 

routines, regexp: regular regexp.5 

routines, /tgoto, tputs: termcap.3 

rsh: shell, the sh.l 

rstat: network statistics rstat.ln 

run a command at low priority. . . . nice.l 

run a command immune to nohup. 1 

run daily accounting runacct. Im 

runacct: run daily accounting runacct. Im 

runacct, shutacct, startup,/ acctsh.lm 

ruptime: show host status of ruptime.ln 

rwho: who is logged in on rwho.ln 

sal, sa2, sadc: system sar.lm 

sa2, sadc: system activity sar.lm 

sact: print current SCeS file sact.l 

sadc: system activity report sar.lm 

sadp: disk access profiler sadp.l 

sag: system activity graph sag.lg 

sar: system activity reporter sar. 1 

sbrk: change data segment brk.2 

scanf, fscanf, sscanf: convert .... scanf.3s 

scanner bfs.l 

scanning and processing awk.l 

sees delta, cdc: change cdc.l 

sees deltas comb.l 

sees file, delta: delta. 1 

sees file get.l 

sees file prs.l 

sees file rmdel.l 

sees file. sccsdiflF: sccsdiff.l 

sees file sccsfile.4 

sees file, unget: unget.l 

sees file val.l 

sees file editing activity sact.l 

sees files admin.l 

sees files what.l 

sccsdifT: compare two versions .... sccsdiff.l 

sccsfile: format of SeeS file sccsfile.4 

scheduler and move requests. .... Ipsched.lm 

screen clear.l 

screen twinkle.6 

screen oriented (visual) vi. 1 

script for the init process inittab.4 
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system initialization shell 

program. 

bsearch: binary 

grep, egrep, fgrep: 

accounting file(s). acctcom: 

Isearch: linear 

hcreate, hdestroy: manage hash 

tdelete, twalk: manage binary 

/mrand48, jrand48, srand48, 

shmget: get shared memory 

brk, sbrk: change data 

to two sorted files, comm: 

multiplexing. 

greek: 

of a file, cut: cut out 

semctl: 

semop: 

ipcrm: remove a message queue, 

semget: get set of 

operations. 



a group of processes, kill: 

mail, mail, rmail: 

send: 

socket. 

line printer. Ip, cancel: 

reset the teletype bits to a 

stream. 

IDs. setuid, 

getgrent, getgrgid, getgrnam, 

cpu. 

goto. 

encryption, crypt. 



getpwent, getpwuid, getpwnam, 

login time, profile: 

gettydefs: speed and terminal 

disktune - tune floppy disk 

group IDs. 

/getutid, getutline, pututline, 

data in a machine/ sputl, 

standard/ restricted command/ 

operations, shmctl: 

queue, semaphore set or 

shmop: 

shmget: get 

remsh: remote 

system: issue a 

with C-like syntax, csh: a 

shutacct, startup, turnacct: 

system initialization 

command programming/ sh, rsh: 

operations. 

segment. 

operations. 

/prdaily, prtacct, runacct, 

processing. 

program, sdiff: 

login: 

pause: suspend process until 

what to do upon receipt of a 



scripts, /re, powerfail: brc.Im 

sdiff: side-by-side difference sdiff. I 

search bsearch.3c 

search a file for a pattern grep. I 

search and print process acctcom. 1 

search and update lsearch.3c 

search tables, hsearch, hsearch.3c 

search trees, tsearch, tsearch.Sc 

sed: stream editor sed.l 

seed48, lcong48: generate/ drand48.3c 

segment shmget,2 

segment space allocation brk.2 

select or reject lines common .... comm.l 

select: synchronous i/o select.2n 

select terminal filter greek. I 

selected fields of each line cut.l 

semaphore control operations semctl.2 

semaphore operations semop.2 

semaphore set or shared memory/ . . ipcrm. 1 

semaphores ; . . . semget.2 

semctl: semaphore control semctl.2 

semget: get set of semaphores semget.2 

semop: semaphore operations semop.2 

send a signal to a process or kill.2 

send mail to users or read mail.l 

send message from a socket send.2 

send: send message from a send.2 

send/ cancel requests to an LP .... Ip.l 

sensible state, /reset: set or tset.l 

setbuf: assign buffering to a setbuf.3s 

setgid: set user and group setuid.2 

setgrent, endgrent: get group/ .... getgrent.3c 

sethostname: set name of host .... sethostname.2n 

setjmp, longjmp: non-local setjmp.3c 

setkey, encrypt: generate DES .... crypt.3c 

setmnt: establish mount table setmnt.lm 

setpgrp: set process group ID setpgrp.2 

setpwent, endpwent: get/ getpwent.3c 

setting up an environment at .... profile.4 

settings used by getty gettydefs.4 

settling time parameters disktune. Im 

setuid, setgid: set user and setuid.2 

setutent, endutent, utmpname:/ . . . getut.3c 

sgetl: access long numeric sputl.3x 

sh, rsh: shell, the sh.l 

shared memory control shmctl.2 

shared memory id. /a message . . . ipcrm. 1 

shared memory operations shmop.2 

shared memory segment shmget.2 

shell remsh.ln 

shell command system.3s 

shell (command interpreter) csh.l 

shell procedures for/ /runacct, . . . acctsh.lm 

shell scripts, /re, powerfail: brc.Im 

shell, the standard/ restricted .... sh.l 

shmctl: shared memory control . . . shmctl.2 

shmget: get shared memory shmget.2 

shmop: shared memory shmop.2 

shutacct, startup, turnacct:/ acctsh.lm 

shutdown: terminate all shutdown. Im 

side-by-side difference sdiff. 1 

sign on login.l 

signal pause.2 

signal, signal: specify signal.2 
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upon receipt of a signal. 

of processes, kill: send a 

ssignal, gsignal: software 

lex: generate programs for 

generator, rand, srand: 

to: phototypesetter 

atan, atan2: trigonometric/ 

ssp: make output 

functions. 

size: 

an interval. 

interval. 

documents, view graphs, and 

typesetting view graphs and 

current/ ttyslot: find the 

spline: interpolate 

sno: 

accept a connection on a 

initiate a connection on a 

receive message from a 

send: send message from a 

address associated with a 

communication. 

associated with a socket. 

loop: 

ssignal, gsignal: 

qsort: quicker 

tsort: topological 

sort: 

or reject lines common to two 

message file by massaging C 

brk, sbrk: change data segment 

ssp: make output single 

terminal, ct: 

fspec: format 

the extended errors in the 

receipt of a signal, signal: 

/set terminal type, modes, 

used by getty. gettydefs: 

hashcheck: find spelling/ 

spelling/ spell, hashmake, 

spellin, hashcheck: find 

curve. 

csplit: context 

split: 

efl files, fsplit: 

pieces. 

uuclean: uucp 

Ipr: line printer 

Ipadmin: configure the LP 

output, printf, fprintf, 

numeric data in a machine/ 

power,/ exp, log, loglO, pow, 

exponential, logarithm, power, 

generator, rand, 

/nrand48, mrand48, jrand48, 

formats suitable for Motorola 

rcvhex: translates Motorola 

input, scanf, fscanf, 

signals. 

spaced. 



signal: specify what to do signal.2 

signal to a process or a group .... kill.2 

signals ssignal.3c 

simple lexical tasks lex.l 

simple random-number rand.3c 

simulator tc.l 

sin, cos, tan, asin, acos, trig.3m 

single spaced ssp.l 

sinh, cosh, tanh: hyperbolic sinh.3m 

size of an object file size.l 

size: size of an object file size.l 

sleep: suspend execution for sleep. 1 

sleep: suspend execution for sleep.3c 

slides, mmt, mvt: typeset mmt.l 

slides, /macro package for mv.5 

slot in the utmp file of the ttyslot.3c 

smooth curve spline. Ig 

sno: SNOBOL interpreter sno.l 

SNOBOL interpreter sno.l 

socket, accept: accept.2n 

socket, connect: connect.2n 

socket, receive: receive.2n 

socket send.2 

socket, socketaddr: return socketaddr.2n 

socket: create an endpoint for .... socket.2n 

socketaddr: return address socketaddr. 2n 

software loopback interface lo.5n 

software signals ssignal.3c 

sort qsort.3c 

sort tsort.l 

sort and/or merge files sort.l 

sort: sort and/ or merge files sort.l 

sorted files, comm: select comm.l 

source, /create an error mkstr.l 

space allocation brk.2 

spaced ssp.l 

spawn getty to a remote ct. 1 c 

specification in text files fspec.4 

specified device, /turn on/off" .... exterr.l 

specify what to do upon signal.2 

speed, and line discipline getty. Im 

speed and terminal settings gettydefs.4 

spell, hashmake, spellin, spell. 1 

spellin, hashcheck: find spell. 1 

spelling errors, /hashmake, spell. 1 

spline: interpolate smooth spline. Ig 

split csplit.l 

split a file into pieces split. 1 

split fortran, ratfor, or fsplit. 1 

split: split a file into split. 1 

spool directory clean-up uuclean. Im 

spooler Ipr.l 

spooling system Ipadmin. Im 

sprintf: print formatted printf.3s 

sputl, sgetl: access long sputl.3x 

sqrt: exponential, logarithm, exp.3m 

square root functions, /sqrt: exp.3m 

srand: simple random-number .... rand.3c 

srand48, seed48, lcong48:/ drand48.3c 

S-record downloading. /ASCII . . . hex.l 

S-records from downloading/ .... rcvhex. 1 

sscanf. convert formatted scanf.3s 

ssignal, gsignal: software ssignal.3c 

ssp: make output single ssp.l 
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package, stdio: 

communication/ stdipc: 

sh, rsh: shell, the 

twinkle: twinkle 

Ipsched, Ipshut, Ipmove: 

boot: 

/prtacct, runacct, shutacct, 

system call. 

Stat: data returned by 

ustat: get file system 

ff: list file names and 

rstat: network 

communication facilities 

ps: report process 

Stat, fstat: get file 

Ipstat: print LP 

feof, clearerr, fileno: stream 

control, uustat: uucp 

ruptime: show host 

input/ output package. 

communication package. 

wait for child process to 

strncmp, strcpy, strncpy,/ 

/strcpy, strncpy, strlen, 

strncpy,/ strcat, strncat, 

/strncat, strcmp, strncmp, 

/strrchr, strpbrk, strspn, 

filush: close or flush a 

fopen, freopen, fdopen: open a 

reposition a file pointer in a 

get character or word from 

fgets: get a string from a 

put character or word on a 

puts, fputs: put a string on a 

setbuf: assign buffering to a 

push character back into input 

sed: 

/feof, clearerr, fileno: 

convert date and time to 

floating-point number to 

long integer and base-64 ASCII 

gps: graphical primitive 

gets, fgets: get a 

puts, fputs: put a 

strspn, strcspn, strtok: 

number, atof: convert ASCII 

strtol, atol, atoi: convert 

strings in an object, or/ 

strings: find the printable 

relocation bits. 

/strncmp, strcpy, strncpy, 

strcpy, strncpy,/ strcat, 

strcat, strncat, strcmp, 

/strcmp, strncmp, strcpy, 

/strlen, strchr, strrchr, 

/strncpy, strlen, strchr, 

/strchr, strrchr, strpbrk, 

/strpbrk, strspn, strcspn, 

string to integer. 

processes using a file or file 

another user. 

plot: graphics interface 



standard buffered input/output . . . stdio.3s 

standard interprocess stdipc.3c 

standard/ restricted command/ . . . . sh.l 

stars on the screen twinkle.6 

start/stop the LP request/ Ipsched. Im 

startup procedures boot.8 

startup, turnacct: shell/ acctsh.lm 

Stat: data returned by stat stat.5 

Stat, fstat: get file status stat.2 

Stat system call stat.5 

statistics ustat.2 

statistics for a file system ff.lm 

statistics program rstat. In 

status, /report inter-process ipcs.l 

status ps.l 

status stat.2 

status information Ipstat. 1 

status inquiries, ferror, ferror.3s 

status inquiry and job uustat. Ic 

status of local machines ruptime. In 

stdio: standard buffered stdio.3s 

stdipc: standard interprocess stdipc.3c 

stime: set time stime.2 

stop or terminate, wait: wait.2 

strcat, strncat, strcmp, string.3c 

strchr, strrchr, strpbrk,/ string.3c 

strcmp, strncmp, strcpy, string.3c 

strcpy, strncpy, strlen,/ string. 3c 

strcspn, strtok: string/ string.3c 

stream, fclose, fclose.3s 

stream fopen.3s 

stream, fseek, rewind, ftell: fseek.3s 

stream, /getchar, fgetc, getw: .... getc.3s 

stream, gets gets.3s 

stream, /putchar, fputc, putw: .... putc.3s 

stream puts.3s 

stream setbuf.3s 

stream, ungetc: ungetc.3s 

stream editor sed.l 

stream status inquiries ferror.3s 

string, /asctime, tzset: ctime.3c 

string, /fcvt, gcvt: convert ecvt.3c 

string. /164a: convert between .... h641.3c 

string, format of graphical/ gps.4 

string from a stream gets.3s 

string on a stream puts.3s 

string operations, /strpbrk, string.3c 

string to floating-point atof 3c 

string to integer strtol.3c 

strings: find the printable strings.! 

strings in an object, or other/ .... strings.! 

strip: remove symbols and strip. 1 

strlen, strchr, strrchr,/ string. 3c 

strncat, strcmp, strncmp, string.3c 

strncmp, strcpy, strncpy,/ string.3c 

strncpy, strlen, strchr,/ string.3c 

strpbrk, strspn, strcspn,/ string.3c 

strrchr, strpbrk, strspn,/ string.3c 

strspn, strcspn, strtok:/ string.3c 

strtok: string operations string.3c 

strtol, atol, atoi: convert strtol.3c 

structure, fuser: identify fuser.lm 

su: become super-user or su.l 

subroutines plot.3x 



-32 



Permuted Index 



intro: introduction to 

/same lines of several files or 

/files into ASCII formats 

file. sum7: 

the files in the/ sumdir: 

count of a file. 

a file. 

characters in the files in/ 

du: 

accounting/ acctcms: command 

sync: update the 

sync: update 

su: become 

interval, sleep: 

interval, sleep: 

pause: 

swab: 
strip: remove 



select: 

interpreter) with C-like 

error/ perror, errno, 

perror, errno, sys_errlist, 

information, uvar: returns 

uuto, uupick: public UNIX 

master device information 

mnttab: mounted file system 

setmnt: establish mount 

/etc/ hosts: host 

hdestroy: manage hash search 

tbl: format 

tabs: set 

ctags: maintain a 

a file. 

remote machine. 

remote machine.. 

machine, take: 

machine.. take7: 

trigonometric/ sin, cos, 

sinh, cosh, 

recover files from a backup 

tp: manipulate 

hpio: HP 2645A terminal 

tar: 

tp: magnetic 

file system backup, filesave, 

programs for simple lexical 

deroff": remove nroff/troff", 

or trofi". 

Control Protocol, 
search trees, tsearch, 

4014: paginator for the 

tset, reset: set or reset the 

initialization, init, 

temporary file, tmpnam, 

tmpfile: create a 

tempnam: create a name for a 

terminals. 



subroutines and libraries intro.3 

subsequent lines of one file paste. 1 

suitable for Motorola S-record/ . . . hex.l 

sum and count blocks in a sumT.l 

sum and count characters in sumdir.l 

sum: print checksum and block . . . sum.l 

sum?: sum and count blocks in . . . sumT.l 

sumdir: sum and count sumdir.l 

summarize disk usage du.l 

summary from per-process acctcms. Im 

super block sync.l 

super-block sync.2 

super-user or another user su.l 

suspend execution for an sleep. 1 

suspend execution for sleep.3c 

suspend process until signal pause.2 

swab: swap bytes swab.3c 

swap bytes swab.3c 

symbols and relocation bits strip. 1 

sync: update super-block sync.2 

sync: update the super block sync.l 

synchronous i/o multiplexing select.2n 

syntax, csh: a shell (command .... csh.l 

sys_errlist, sys_nerr: system perror.3c 

sys_nerr: system error/ perror.Bc 

system-specific configuration uvar.2 

System-to-UNIX System file/ .... uuto.lc 

table, master: master.4 

table mnttab.4 

table setmnt.lm 

table for bnet hosts.7n 

tables, hsearch, hcreate, hsearch.3c 

tables for nroff" or troff" tbl.l 

tabs on a terminal tabs.l 

tabs: set tabs on a terminal tabs.l 

tags file for a C program ctags. 1 

tail: deliver the last part of tail.l 

take: takes a file from a take.lc 

take?: takes a file from a takeT.lc 

takes a file from a remote take.lc 

takes a file from a remote take7.1c 

tan, asin, acos, atan, atan2: trig.3m 

tanh: hyperbolic functions sinh.3m 

tape, free: frec.lm 

tape archive tp.l 

tape file archiver hpio.l 

tape file archiver tar.l 

tape format tp.4 

tapesave: daily/ weekly UNIX .... filesave. Im 

tar: tape file archiver tar. 1 

tasks, lex: generate « lex.l 

tbl, and eqn constructs deroff. 1 

tbl: format tables for nrofi" tbl.l 

tc: phototypesetter simulator tc.l 

tcp: Internet Transmission tcp.Sn 

tdelete, twalk: manage binary .... tsearch.3c 

tee: pipe fitting tee.l 

Tektronix 4014 terminal 4014.1 

teletype bits to a sensible/ tset.l 

telinit: process control init.lm 

tempnam: create a name for a .... tmpnam.3s 

temporary file tmpfile.3s 

temporary file, tmpnam, tmpnam.3s 

term: conventional names for .... term.5 
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data base. 

for the Tektronix 4014 

functions of the DASI 450 

ct: spawn getty to a remote 

generate file name for 

tabs: set tabs on a 

isatty: find name of a 

animate worms on a display 

termcap: 

greek: select 

/tgetstr, tgoto, tputs: 

termio: general 

tty: controlling 

dial: establish an out-going 

clear: clear 

getty. gettydefs: speed and 

hpio: HP 2645A 

and line/ getty: set 

ttytype: data base of 

functions of DASI 300 and 300s 

of HP 2640 and 2621 -series 

term: conventional names for 

tty: get the 

for child process to stop or 

kill: 

shutdown: 

exit, exit: 

daemon, errstop: 

interface. 

command. 

quiz: 

nroff: format 

troff": typeset 

ed, red: 

ex, edit: 

change the format of a 

fspec: format specification in 

/checkeq: format mathematical 

prepare constant-width 

typesetting. nrofi"7: 

typesetting, troff?: 

plock: lock process, 

tgetstr, tgoto, tputs:/ 

tputs:/ tgetent, tgetnum, 

tgoto, tputs:/ tgetent, 

tgetent, tgetnum, tgetflag, 

/tgetnum, tgetflag, tgetstr, 

ttt, cubic: 

execute commands at a later 

systems for optimal access 

up an environment at login 

stime: set 

time: get 

time: 

data and system/ timex: 

- tune floppy disk settling 
profil: execution 

tzset: convert date and 

clock: report CPU 

get process and child process 

file access and modification 

process times. 



ermcap: terminal capability termcap.5 

:erminal. 4014: paginator 4014.1 

erminal. 450: handle special .... 450.1 

erminal ct.lc 

erminal. ctermid: ctermid.3s 

erminal tabs.l 

erminal. ttyname, ttyname.3c 

erminal. worms: worms.6 

erminal capability data base termcap.5 

erminal filter greek.l 

erminal independent operation/ . . . termcap.3 

erminal interface termio. 7 

erminal interface tty. 7 

erminal line connection dial.3c 

erminal screen clear. 1 

erminal settings used by gettydefs.4 

erminal tape file archiver hpio. 1 

erminal type, modes, speed, .... getty. Im 

erminal types by port ttytype.4 

erminals. /handle special 300.1 

erminals. /special functions hp.l 

erminals term.5 

erminal's name tty. 1 

erminate. wait: wait wait.2 

erminate a process kill.l 

erminate all processing shutdown. Im 

erminate process exit.2 

erminate the error-logging errstop. Im 

ermio: general terminal termio.7 

est: condition evaluation test.l 

est your knowledge quiz.6 

ext nroff.l 

ext troff.l 

ext editor ed.l 

ext editor ex. 1 

ext file, newform: newform.l 

ext files fspec.4 

ext for nroff or troff. eqn. 1 

ext for troff. cw, checkcw: cw.l 

ext formatting and nroff?. 1 

ext formatting and troff7.1 

;ext, or data in memory plock.2 

;getent, tgetnum, tgetflag, termcap.3 

:getflag, tgetstr, tgoto, termcap.3 

:getnum, tgetflag, tgetstr, termcap.3 

getstr, tgoto, tputs:/ termcap.3 

;goto, tputs: terminal/ termcap.3 

ic-tac-toe ttt.6 

ime. at: at.l 

ime. dcopy: copy file dcopy.lm 

ime. profile: setting profile.4 

ime stime.2 

ime time.2 

ime a command time.l 

ime a command; report process . . • timex. 1 

ime: get time time.2 

ime parameters, disktune disktune.lm 

ime profile profil.2 

ime: time a command time. 1 

ime to string, /asctime, ctime.3c 

ime used clock.3c 

imes. times: times.2 

imes. utime: set utime.2 

imes: get process and child ..... times.2 
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update access and modiiication 

process data and system/ 

file. 

for a temporary file. 

/tolower, toupper, tolower, 

popen, pclose: initiate pipe 

toupper, tolower, toupper, 

toascii: translate/ toupper, 

tsort: 

acctmerg: merge or add 

modification times of a file. 

translate/ toupper, tolower, 

tolower, toascii: translate/ 



/tgetflag, tgetstr, tgoto, 

ptrace: process 

bit, blt512: block 

/toupper, tolower, toascii: 

tr: 

from downloading into/ rcvhex: 

ASCII formats suitable/ hex: 

tcp: Internet 

ftw: walk a file 

twalk: manage binary search 

trek: 

tan, asin, acos, atan, atan2: 

constant-width text for 

mathematical text for nroff" or 

format tables for nroff" or 

typesetting view graphs/ mv: a 

typesetting. 

values. 

m68k, pdpll, u3b, vax: provide 

true, false: provide 

robots, chase: 

manage binary search trees. 

teletype bits to a sensible/ 



interface. 

graphics for the extended 

a terminal. 

utmp file of the current/ 

types by port. 

parameters, disktune - 

/runacct, shutacct, startup, 

trees, tsearch, tdelete, 

twinkle: 

screen. 

file: determine file 

value about your processor 

getty: set terminal 

for the extended TTY-37 

types: primitive system data 

ttytype: data base of terminal 

types. 

graphs, and slides, mmt, mvt: 

troff": 



imes of a file, touch: touch. 1 

imex: time a command; report . . . timex.l 

mpfile: create a temporary tmpfile.3s 

mpnam, tempnam: create a name . . tmpnam.Ss 

oascii: translate characters conv.3c 

o/from a process popen.3s 

tolower, toascii: translate/ conv.3c 

olower, _toupper, tolower, conv.3c 

opological sort tsort. 1 

otal accounting files acctmerg. Im 

ouch: update access and touch. 1 

toupper, _tolower, toascii: conv.3c 

oupper, tolower, toupper, conv.3c 

p: magnetic tape format tp.4 

p: manipulate tape archive tp.l 

plot: graphics filters tplot.lg 

puts: terminal independent/ .... termcap.3 

r: translate characters tr. 1 

race ptrace.2 

ransfer data blt.3 

ranslate characters conv.3c 

ranslate characters tr. 1 

ranslates Motorola S-records .... rcvhex. 1 

ranslates object files into hex.l 

Transmission Control Protocol. . . . tcp.Sn 

ree ftw.3c 

rees. tsearch, tdelete, tsearch.3c 

rek: trekkie game trek.6 

rekkie game trek.6 

rigonometric functions, /cos, .... trig.3m 

roff". cw, checkcw: prepare cw.l 

roff". /neqn, checkeq: format .... eqn.l 

roff. tbl: tbl.l 

roff" macro package for mv.5 

roff": typeset text troff".! 

roff7: text formatting and troff"7.1 

rue, false: provide truth true.l 

ruth value about your/ machid.1 

ruth values true.l 

Try to escape the killer chase.6 

tsearch, tdelete, twalk: tsearch.3c 

set, reset: set or reset the tset. 1 

sort: topological sort tsort. 1 

tt, cubic: tic-tac-toe ttt.6 

:ty: controlling terminal tty.7 

ty: get the terminal's name tty.l 

TTY-37 type-box. greek: greek.5 

tyname, isatty: find name of .... ttyname.3c 

tyslot: find the slot in the ttyslot.3c 

tytype: data base of terminal .... ttytype.4 

une floppy disk settling time .... disktune. Im 

urnacct: shell procedures for/ .... acctsh.lm 

walk: manage binary search tsearch.3c 

winkle stars on the screen twinkle.6 

winkle: twinkle stars on the twinkle.6 

ype file.l 

ype. /u3b, vax: provide truth .... machid.1 

ype, modes, speed, and line/ .... getty. Im 

ype-box. greek: graphics greek.5 

ypes types.5 

ypes by port. ttytype.4 

ypes: primitive system data types.5 

ypeset documents, view mmt.l 

ypeset text troff".l 
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nroir?: text formatting and 

troff?: text formatting and 

mv: a troff macro package for 

/localtime, gmtime, asctime, 

about your/ m68k, pdpll. 

Protocol. 

getpw: get name from 

limits. 

creation mask. 

mask. 

file system, mount, 

UNIX system. 

UNIX System. 

ul: do 

file, unget: 

an sees file. 

into input stream. 

/seed48, lcong48: generate 

a file. 

mktemp: make a 

unlink system calls, link, 

entry. 

unlink: exercise link and 

umount: 

files, pack, peat, 

Isearch: linear search and 

times of a file, touch: 

of programs, make: maintain, 

badblk: program to set or 

machines, updater: 

machines, updater: 

sync: 

sync: 

two machines. 

two machines. 

du: summarize disk 

character login name of the 

logname: return login name of 

become super-user or another 

the utmp file of the current 

write: write to another 

setuid, setgid: set 

id: print 

udp: Internet 

/getgid, getegid: get real 

environ: 

environ: 

ulimitr get and set 

/get real user, effective 

wall: write to all 

mail, rmail: send mail to 

fuser: identify processes 

statistics. 

modification times. 

utmp, wtmp: 

endutent, utmpname: access 

ttyslot: find the slot in the 

entry formats. 

/pututline, setutent, endutent, 

clean-up. 

uusub: monitor 



typesetting nroff7.1 

typesetting troff?. 1 

typesetting view graphs and/ .... mv.5 

tzset: convert date and time/ .... ctime.3c 

u3b, vax: provide truth value .... machid.l 

udp: Internet User Datagram .... udp.Sn 

UID getpw.3c 

ul: do underlining ul.l 

ulimit: get and set user ulimit.2 

umask: set and get file umask.2 

umask: set file-creation mode .... umask. 1 

umount: mount and dismount .... mount. Im 

umount: unmount a file system. . . . umount.2 

uname: get name of current uname.2 

uname: print name of current .... uname. 1 

underlining ul.l 

undo a previous get of an SeeS . . . unget. 1 

unget: undo a previous get of .... unget. 1 

ungetc: push character back ungetc.3s 

uniformly distributed/ drand48.3c 

uniq: report repeated lines in .... uniq. 1 

unique file name mktemp.3c 

units: conversion program units.! 

unlink: exercise link and hnk.lm 

unlink: remove directory unlink.2 

unlink system calls, link, link.lm 

unmount a file system umount.2 

unpack: compress and expand .... pack.l 

update lsearch.3c 

update access and modification . . . touch. 1 

update, and regenerate groups .... make.l 

update bad block information badblk. Im 

update files between two updater. 1 

update files between two updater. Im 

update super-block sync.2 

update the super block sync.l 

updater: update files between .... updater. 1 

updater: update files between .... updater. Im 

usage du.l 

user, cuserid: get . cuserid.3s 

user . logname.3x 

user, su: su.l 

user, /find the slot in ttyslot.3c 

user write.l 

user and group IDs setuid.2 

user and group IDs and names. . . . id.l 

User Datagram Protocol udp.Sn 

user, effective user, real/ getuid.2 

user environment environ.4 

user environment environ.5 

user limits . ulimit.2 

user, real group, and/ getuid.2 

users wall.lm 

users or read mail. mail. 1 

using a file or file/ fuser.lm 

ustat: get file system ustat.2 

utime: set file access and utime.2 

utmp and wtmp entry formats utmp.4 

utmp file entry, /setutent, getut.3c 

utmp file of the current user ttyslot.3c 

utmp, wtmp: utmp and wtmp .... utmp.4 

utmpname: access utmp file/ .... getut.3c 

uuclean: uucp spool directory .... uuclean.lm 

UUCP network uusub. I m 
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uuclean: 

control, uustat: 

Unix copy. 

copy. UUCP, 

UUCP, uulog, 

System-to-UNIX System/ uuto, 

and job control. 

System-to-UNIX System file/ 

execution. 

configuration information. 

val: 

abs: return integer absolute 

/pdpll, u3b, vax: provide truth 

getenv: return 

ceiling, remainder, absolute 

true, false: provide truth 

your/ m68k, pdpll, u3b. 



option letter from argument 

assert: 

of directory (Berkeley 

vchk: 

vc: 

version: reports 

get: get a 

number of files. 

sccsdifi": compare two 

(visual) display editor based/ 

mmt, mvt: typeset documents, 

macro package for typesetting 

display editor based on/ vi, 

file perusal filter for crt 

on/ vi, view: screen oriented 

systems with label checking. 

file system: format of system 

process. 

or terminate, wait: 

to stop or terminate. 

ftw: 



signal, signal; specify 

crashes, crash: 

whodo: 

machines, rwho: 

who: 



cd: change 

chdir: change 

get pathname of current 

pwd: 

worm: Play the growing 

game. 

display terminal. 

worms: animate 

write: 

putpwent: 

wall: 

write: 



UUCP spool directory clean-up uuclean. Im 

UUCP status inquiry and job uustat. Ic 

UUCP, uulog, uuname: unix to .... uucp.lc 

uulog, uuname: unix to unix .... uucp.lc 

uuname: unix to unix copy uucp.lc 

uupick: public UNIX uuto.lc 

uustat: UUCP status inquiry uustat. I c 

uusub: monitor UUCP network uusub.lm 

uuto, uupick: public UNIX uuto.lc 

uux: unix to unix command uux.lc 

uvar: returns system-specific uvar.2 

val: validate SCCS file val.l 

validate sees file val.l 

value abs.Sc 

value about your processor/ machid.l 

value for environment name getenv.Sc 

value functions, /fabs: floor, .... floor.3m 

values true.l 

vax: provide truth value about .... machid.l 

vc: version control vc.l 

vchk: version checkup vchk.lm 

vector, getopt: get getopt.Sc 

verify program assertion assert.3x 

version). Is7: list contents Is7.1 

version checkup vchk.lm 

version control vc.l 

version number of files version. 1 

version of an sees file get.l 

version: reports version version. 1 

versions of an sees file sccsdiff.l 

vi, view: screen oriented vi.l 

view graphs, and slides mmt.l 

view graphs and slides, /troff" .... mv.5 

view: screen oriented (visual) .... vi.l 

viewing, more: more.l 

(visual) display editor based vi.l 

volcopy, labelit: copy file volcopy.lm 

volume fs.4 

wait: await completion of wait.l 

wait for child process to stop .... wait.2 

wait: wait for child process wait.2 

walk a file tree ftw. 3c 

wall: write to all users wall.lm 

wc: word count wc. 1 

what: identify sees files. what.l 

what to do upon receipt of a signal.2 

what to do when the system crash.8 

who is doing what whodo.lm 

who is logged in on local rwho. In 

who is on the system who.l 

who: who is on the system who.l 

whodo: who is doing what whodo.lm 

working directory cd.l 

working directory chdir.2 

working directory, getcwd: getcwd.3c 

working directory name pwd.l 

worm game worm.6 

worm: Play the growing worm .... worm.6 

worms: animate worms on a worms.6 

worms on a display terminal worms.6 

write on a file write.2 

write password file entry putpwent.3c 

write to all users wall.lm 

write to another user write. 1 
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write: write on a file write.2 

write: write to another user write. 1 

file regions for reading or writing, /provide exclusive lockf.2 

open: open for reading or writing open.2 

utmp, wtmp: utmp and wttnp entry formats. utmp.4 

formats, utmp, wtmp: utmp and wtmp entry .... utmp.4 

accounting records, fwtmp, wtmpfix: manipulate connect .... fwtmp.lm 

hunt-the-wumpus. wump: the game of wump.6 

list(s) and execute command, xargs: construct argument xargs.l 

jO, jl,jn, yO, yl, yn: Bessel functions bessel.3m 

jO, jl, jn, yO, yl, yn: Bessel functions bessel.3m 

compiler-compiler, yacc: yet another yacc.l 

jO, jl, jn, yO, yl, yn: Bessel functions bessel.3m 



-38 



INTRO (IM) INTRO (IM) 



NAME 

intro — introduction to system maintenance commands and application pro- 
grams 

DESCRIPTION 

This section describes, in alphabetical order, commands that are used 
chiefly for system maintenance and administration purposes. The com- 
mands in this section should be used along with those listed in Section 1 of 
the UniPlus'^ User's Manual. References to other manual entries not of the 
form name(\M), named) or nameiS) refer to entries of that manual. 

COMMAND SYNTAX 

Unless otherwise noted, commands described in this section accept options 
and other arguments according to the following syntax: 

name [optionis)] [cmdarg(s)] 
where: 

name The name of an executable file. 

option — noargletter(s) or, 

— argletter< > optarg 

where <> is optional white space. 

noargletter A single letter representing an option without an argument. 
argletter A single letter representing an option requiring an argument. 

optarg Argument (character string) satisfying preceding argletter. 

cmdarg Path name (or other command argument) not beginning with 

— or, — by itself indicating the standard input. 

SEE ALSO 

getopt(l), getoptOC). 
UniPlus'^ User's Manual. 
UnlPlus'^ Administrator's Guide. 

DIAGNOSTICS 

Upon termination, each command returns two bytes of status, one supplied 
by the system and giving the cause for termination, and (in the case of 
"normal" termination) one supplied by the program (see wait(2) and 
exit(2)). The former byte is for normal termination; the latter is cus- 
tomarily for successful execution and non-zero to indicate troubles such 
as erroneous parameters, bad or inaccessible data, or other inability to cope 
with the task at hand. It is called variously "exit code", "exit status", or 
"return code", and is described only where special ^conventions are 
involved. 



BUGS 



Regretfully, many commands do not adhere to the aforementioned syntax. 
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NAME 

accept, reject — allow/ prevent LP requests 

SYNOPSIS 

/usr/lib/accept destinations 
/usr/lib/reject [—r[ reason]] destinations 

DESCRIPTION 

Accept aWows lpi\) to accept requests for the named destinations. A destina- 
tion can be either a printer or a class of printers. Use Ipstat(l) to find the 
status of destinations. 

Reject prevents lp(\) from accepting requests for the named destinations. A 
destination can be either a printer or a class of printers. Use Ipstatil) to 
find the status of destinations. The following option is useful with reject. 

— r[ reason] Associates a reason with preventing Ip from accepting 
requests. This reason applies to all printers mentioned up to 
the next — r option. Reason is reported by Ip when users 
direct requests to the named destinations and by Ipstatil). If 
the — r option is not present or the — r option is given 
without a reason, then a default reason will be used. 



FILES 



/usr/spool/lp/* 



SEE ALSO 

enabled), lp(l), Ipadmin(lM), Ipsched(lM), Ipstat(l). 
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NAME 

acctdisk, acctdusg, accton, acctwtmp — overview of accounting and miscel- 
laneous accounting commands 

SYNOPSIS 

/usr/lib/acct/acctdisk 

/usr/Iib/acct/acctdusg [-u file] [-p file] 

/usr/lib/acct/accton [file] 

/usr/lib/acct/acctwtmp "reason" 

DESCRIPTION 

Accounting software is structured as a set of tools (consisting of both C 
programs and shell procedures) that can be used to build accounting sys- 
tems. AcctshilM) describes the set of shell procedures built on top of the 
C programs. 

Connect time accounting is handled by various programs that write records 
into /usr/adm/utmp, as described in utmpiA). The programs described in 
acctconilM) convert this file into session and charging records, which are 
then summarized by acctmergilM) . 

Process accounting is performed by the UNIX System kernel. Upon termi- 
nation of a process, one record per process is written to a file (normally 
/usr/adm/pacct). The programs in acctprc{\'M) summarize this data for 
charging purposes; acctcms{\}A) is used to summarize command usage. 
Current process data may be examined using acctcom{\) . 

Process accounting and connect time accounting (or any accounting records 
in the format described in acct{A)) can be merged and summarized into 
total accounting records by acctmerg (see tacct format in acct{A)). Prtacct 
(see acctshiXM)) is used to format any or all accounting records. 

Acctdisk reads lines that contain user ID, login name, and number of disk 
blocks and converts them to total accounting records that can be merged 
with other accounting records. 

Acctdusg reads its standard input (usually from find / —print) and com- 
putes disk resource consumption (including indirect blocks) by login. If 
— u is given, records consisting of those file names for which acctdusg 
charges no one are placed in file (a potential source for finding users trying 
to avoid disk charges). If — p is given, file is the name of the password file. 
This option is not needed if the password file is /etc/passwd. 

Accton alone turns process accounting off. If file is given, it must be the 
name of an existing file, to which the kernel appends process accounting 
records (see acctO.) and acct{A)). 

Acctwtmp writes a utmp{A) record to its standard output. The record con- 
tains the current time and a string of characters that describe the reason. A 
record type of ACCOUNTING is assigned (see utmp{A)). Reason must be a 
string of 11 or less characters, numbers, $, or spaces. For example, the fol- 
lowing are suggestions for use in reboot and shutdown procedures, respec- 
tively: 

acctwtmp '*uname^ > > /etc/wtmp 
acctwtmp "file save" > > /etc/wtmp 

FILES 

/etc/passwd used for login name to user ID conversions 
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/usr/lib/acct holds all accounting commands listed in 

sub-class IM of this manual 
/usr/adm/pacct current process accounting file 
/etc/wtmp login/logoff history file 

SEE ALSO 

acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), acctprc(lM), 
acctsh(lM), fwtmp(lM), runacct(lM), acct(2), acct(4), utmp(4). 
"UNIX System Accounting" in the UniPlus^ Administrator's Guide. 
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NAME 

acctcms — command summary from per-process accounting records 

SYNOPSIS 

/usr/lib/acct/acctctns [options] files 

DESCRIPTION 

Acctcms reads one or more files, normally in the form described in accti4). 
It adds all records for processes that executed identically-named commands, 
sorts them, and writes them to the standard output, normally using an 
internal summary format. The options are: 

-a Print output in ASCII rather than in the internal summary format. 
The output includes command name, number of times executed, 
total kcore-minutes, total CPU minutes, total real minutes, mean 
size (in K), mean CPU minutes per invocation, and "hog factor", 
as in acctcomil). Output is normally sorted by total kcore-minutes. 

— c Sort by total CPU time, rather than total kcore-minutes. 

— j Combine all commands invoked only once under "***other". 

— n Sort by number of command invocations. 

-s Any file names encountered hereafter are already in internal sum- 
mary format. 

EXAMPLE 

A typical sequence for performing daily command accounting and for main- 
taining a running total is: 

acctcms file . . . > today 

cp total previoustotal 

acctcms — s today previoustotal > total 

acctcms —a — s today 

SEE ALSO 

acct(lM), acctcom(l), acctcon(lM), acctmerg(lM), acctprc(lM), 
acctsh(lM), fwtmp(lM), runacct(lM), acct(2), acct(4), utmp(4). 
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NAME 

acctconl, acctcon2 — connect-time accounting 

SYNOPSIS 

/usr/lib/acct/acctconl [options] 

/usr/Iib/acct/acctcon2 

DESCRIPTION 

Acctconl converts a sequence of login/logoff records read from its standard 
input to a sequence of records, one per login session. Its input should nor- 
mally be redirected from /etc/wtmp. Its output is ASCII, giving device, 
user ID, login name, prime connect time (seconds), non-prime connect 
time (seconds), session starting time (numeric), and starting date and time. 
The options are: 

— p Print input only, showing line name, login name, and time (in 

both numeric and date/ time formats). 

— t Acctconl maintains a list of lines on which users are logged in. 

When it reaches the end of its input, it emits a session record for 
each line that still appears to be active. It normally assumes that 
its input is a current file, so that it uses the current time as the 
ending time for each session still in progress. The — t flag causes 
it to use, instead, the last time found in its input, thus assuring 
reasonable and repeatable numbers for non-current files. 

— \Jile File is created to contain a summary of line usage showing line 

name, number of minutes used, percentage of total elapsed time 
used, number of sessions charged, number of logins, and number 
of logoff's. This file helps track line usage, identify bad lines, and 
find software and hardware oddities. Hang-up, termination of 
loginil) and termination of the login shell generate a logoff 
records, so that the number of logoffs is often three to four times 
the number of sessions. See /«/7(lM) and utmp(4). 

— file File is filled with an overall record for the accounting period, giv- 

ing starting time, ending time, number of reboots, and number of 
date changes. 

Acctconl expects as input a sequence of login session records and converts 
them into total accounting records (see tacct format in accr(4)). 

EXAMPLE 

These commands are typically used as shown below. The file ctmp is 
created only for the use of flccrpfc( IM) commands: 

acctconl — t — 1 lineuse — o reboots <wtmp| sort +ln +2 >ctmp 
acctcon2 <ctmp| acctmerg >ctacct 

FILES 

/etc/wtmp 

SEE ALSO 

acct(IM), acctcms(lM), acctcom(I), acctmerg(lM), acctprc(lM), 
acctsh(IM), fwtmp(lM), runacct(lM), acct(2), acct(4), utmp(4). 

BUGS 

The line usage report is confused by date changes. Use wtmpjix (see 
fwtmp{\M)) to correct this situation. 
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NAME 

acctmerg — merge or add total accounting files 

SYNOPSIS 

/usr/lib/acct/acctmerg [options] [file] . . . 

DESCRIPTION 

Acctmerg reads its standard input and up to nine additional files, all in the 
tacct format (see acct(4)), or an ASCII version thereof. It merges these 
inputs by adding records whose keys (normally user ID and name) are 
identical, and expects the inputs to be sorted on those keys. Options are: 

— a Produce output in ASCII version of tacct. 

— i Input files are in ASCII version of tacct. 

— p Print input with no processing. 

— t Produce a single record that totals all input. 

— u Summarize by user ID, rather than user ID and name. 

— V Produce output in verbose ASCII format, with more precise notation 

for floating point numbers. 

EXAMPLE 

The following sequence is useful for making "repairs" to any file kept in 
this format: 

acctmerg — v <filel >file2 
edit file2 as desired . . . 
acctmerg —a <file2 >filel 

SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctcon(lM), acctprc(lM), 
acctsh(lM), fwtmp(lM), runacct(lM), acct(2), acct(4), utmp(4). 



October 1983 - 1 - 



ACCTPRC ( 1 M ) ACCTPRC ( 1 M ) 



NAME 

acctprcl, acctprc2 — process accounting 

SYNOPSIS 

/usr/lib/acct/acctprcl [ctmp] 

/usr/lib/acct/acctprc2 

DESCRIPTION 

Acctprcl reads input in the form described by acctiA), adds login names 
corresponding to user IDs, then writes for each process an ASCII line giving 
user ID, login name, prime CPU time (tics), non-prime CPU time (tics), and 
mean memory size (in 64-byte units). If ctmp is given, it is expected to 
contain a list of login sessions, in the form described in acctconilM) , 
sorted by user ID and login name. If this file is not supplied, it obtains 
login names from the password file. The information in ctmp helps it dis- 
tinguish among different login names that share the same user ID. 

Acctprc2 reads records in the form written by acctprcl, summarizes them by 
user ID and name, then writes the sorted summaries to the standard output 
as total accounting records. 

EXAMPLE 

These commands are typically used as shown below: 

acctprcl ctmp </usr/adm/pacct j acctprc2 > placet 

FILES 

/etc/passwd 

SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), 
acctsh(lM), fwtmp(lM), runacct(lM), acct(2), acct(4), utmp(4). 

BUGS 

Although it is possible to distinguish among login names that share user 
IDs for commands run normally, it is difficult to do this for those com- 
mands run from cronilM), for example. More precise conversion can be 
done by faking login sessions on the console via the acctwtmp program in 
accr(lM). 
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NAME 

chargefee, ckpacct, dodisk, lastlogin, monacct, nuUadm, prctmp, prdaily, 
prtacct, runacct, shutacct, startup, turnacct — shell procedures for account- 
ing 

SYNOPSIS 

/usr/lib/acct/chargefee login-name number 

/usr/lib/acct/ckpacct [blocks] 

/usr/lib/acct/dodisk 

/usr/lib/acct/lastlogin 

/usr/lib/acct/monacct number 

/usr/lib/acct/nulladm file 

/usr/lib/acct/prctmp 

/usr/lib/acct/prdaily [ mmdd ] 

/usr/lib/acct/prtacct file [ "heading" ] 

/usr/lib/acct/runacct [mmdd] [mmdd state] 

/usr/lib/acct/shutacct [ "reason" ] 

/usr/lib/acct/startup 

/usr/lib/acct/turnacct on | off | switch 

DESCRIPTION 

Chargefee can be invoked to charge a number of units to login-name. A 
record is written to /usr/adm/fee, to be merged with other accounting 
records during the night. 

Ckpacct should be initiated via cron(lM). It periodically checks the size of 
/usr/adm/pacct. If the size exceeds blocks, 1000 by default, turnacct will 
be invoked with argument switch. If the number of free disk blocks in the 
/usr file system falls below 500, ckpacct will automatically turn off the col- 
lection of process accounting records via the off argument to turnacct. 
When at least this number of blocks is restored, the accounting will be 
activated again. This feature is sensitive to the frequency at which ckpacct 
is executed, usually by cron. 

Dodisk should be invoked by cron to perform the disk accounting functions. 

Lastlogin is invoked by runacct to update /usr/adm/acct/sum/loginlog, 
which shows the last date on which each person logged in. 

Monacct should be invoked once each month or each accounting period. 
Number indicates which month or period it is. If number is not given, it 
defaults to the current month (01 — 12). This default is useful if monacct is 
to executed via cron(lM) on the first day of each month. Monacct CTeates 
summary files in /usr/adm/acct/fiscal and restarts summary files in 
/usr/adm/acct/sutn. 

Nulladm creates file with mode 664 and insures owner and group are adm. 
It is called by various accounting shell procedures. 

Prctmp can be used to print the session record file (normally 
/usr/adm/acct/nite/ctmp created by acctconl (see acctcon{\M)) . 

Prdaily is invoked by runacct to format a report of the previous day's 
accounting data. The report resides in /usr/adm/acct/sum/rprtm/nt/c/ 
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where mmdd is the month and day of the report. The current daily 
accounting reports may be printed by typing prdaily. Previous days' 
accounting reports can be printed by using the mmdd option and specifying 
the exact report date desired. Previous daily reports are cleaned up and 
therefore inaccessible after each invocation of monacct. 

Prtacct can be used to format and print any total accounting (tacct) file. 

Runacct performs the accumulation of connect, process, fee, and disk 
accounting on a daily basis. It also creates summaries of command usage. 
For more information, see runacctilM). 

Shutacct should be invoked during a system shutdown (usually in 
/etc/shutdown) to turn process accounting off and append a "reason" 
record to /etc/wtmp. 

Startup should be called by /etc/re to turn the accounting on whenever the 
system is brought up. 

Turnacct is an interface to accton (see acc/(lM)) to turn process accounting 
on or off. The switch argument turns accounting off, moves the current 
/usr/adm/pacct to the next free name in /usr/adm/pacct/rtcr (where incr'xs 
a number starting with 1 and incrementing by one for each additional pacct 
file), then turns accounting back on again. This procedure is called by 
ckpacct and thus can be taken care of by the cron and used to keep pacct to 
a reasonable size. 



FILES 



/usr/adm/fee accumulator for fees 

/usr/adm/pacct current file for per-process accounting 

/usr/adm/pacct* used if pacct gets large and during 

execution of daily accounting procedure 
/etc/wtmp login/logoff summary 

/usr/adm/acct/nite working directory 
/usr/lib/acct holds all accounting commands listed in 

sub-class IM of this manual 
/usr/adm/acct/sum summary directory, should be saved 

SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), 
acctprc(lM), fwtmp(lM), runacct(lM), acct(2), acct(4), utmp(4). 



October 1983 - 2 



BADBLK(IM) (UniSoft) BADBLK(IM) 



NAME 

badblk — program to set or update bad block information 

SYNOPSIS 

badblk [ -w ] [ -m N] /dev/rXYZ [ #S ] 

DESCRIPTION 

Badblk sets or updates bad block information for those disk drives that sup- 
port soft sector bad block remapping. 

If invoked with the -w option, write/ verify is performed to determine if 
there is a bad block; otherwise only read is done. 

If invoked with the -mN option, the number of alternate blocks will be set 
to N. Badblk returns an error if N > NICALT (currently 50) . 

/dev/rXYZ is the device name. 

#S is one or more block numbers separated by blanks. 

If invoked with no specific block numbers and no bad block verification has 
been done before, then each block on the disk is checked (either read or 
write/verify) and bad block information in block is set up from scratch. 

If invoked with no specific block numbers, but block already contains bad 
block information set up earlier, then a verification on the whole disk is 
performed; any new bad blocks not already on the block table will be 
added. 

If invoked with the device name plus block numbers, then only the indi- 
cated blocks are updated in block 0. 

After alternate blocks are assigned, block is updated and the updated 
blocks are verified to make sure alternate blocks are good. If alternate 
blocks are not good, new alternate block numbers are assigned. 

The raw device that accesses the entire disk and allows for writing block 
zero should be specified. 

EXAMPLE 

badblk -w /dev/rwlhwO 

does a full write/verify on Winchester 1 and updates the header block. The 
rwlhwO specifies raw (r) Winchester 1 (wl), the full disk (h), with the 
capability of writing block (wO) . 

badblk /dev/rwlhwO 3754 8123 

adds blocks 3754 and 8123 to the badblock list. 
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NAME 

bcopy — interactive block copy 

SYNOPSIS 

/etc/bcopy 

DESCRIPTION 

Bcopy dates from a time when neither the UNIX file system nor disk drives 
were as reliable as they are now. Bcopy copies from and to files starting at 
arbitrary block (512-byte) boundaries. 

The following questions are asked: 

to: (you name the file or device to be copied to). 

offset: (you provide the starting "to" block number). 

from: (you name the file or device to be copied from). 

offset: (you provide the starting "from" block number). 

count: (you reply with the number of blocks to be copied). 

After count is exhausted, the from question is repeated (giving you a 
chance to concatenate blocks at the to + offset + count location). If you 
answer from with a carriage return, everything starts over. 

Two consecutive carriage returns terminate bcopy. 

SEE ALSO 

cpio(l), dd(l). 
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NAME 

brc, bcheckrc, re, powerfail — system initialization shell scripts 

SYNOPSIS 

/etc/brc 

/etc/bcheckrc 

/etc/rc 

/etc/powerfail 

DESCRIPTION 

Except for powerfail, these shell procedures are executed via entries in 
/etc/inittab by />i//(lM) when the system is changed out of SINGLE USER 
mode. Power/ail is executed whenever a system power failure is detected. 

The brc procedure clears the mounted file system table, /etc/mnttab (see 
mnttab(4)), and loads any programmable micro-processors with their 
appropriate scripts. 

The bcheckrc procedure performs all the necessary consistency checks to 
prepare the system to change into multi-user mode. It will prompt to set 
the system date and to check the file systems with fsckilM). 

The re procedure starts all system daemons before the terminal lines are 
enabled for multi-user mode. In addition, file systems are mounted and 
accounting, error logging, system activity logging and the Remote Job Entry 
(RJE) system are activated in this procedure. 

The powerfail procedure is invoked when the system detects a power failure 
condition. Its chief duty is to reload any programmable micro-processors 
with their appropriate scripts, if appropriate. It also logs the fact that a 
power failure occurred. 

These shell procedures, in particular re may be used for several run-level 
states. The who(l) command may be used to get the run-level informa- 
tion. 

SEE ALSO 

init(lM), shutdown(lM), who(l), inittab(4). 
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NAME 

chgnod — change current UNIX system nodename 

SYNOPSIS 

chgnod new-name [ kernel-file ] 

DESCRIPTION 

Chgrp accesses the structure defined in <sys/utsname.h> : 

struct utsname { 

char sysname[9]; 
char nodename [9] ; 
char release [9]; 
char version [9]; 

}; 

Chgnod changes the nodename in the kernel-file argument to new-name. If 
no kernel-file is specified, /unix is assumed. Nodename is a null terminated 
string containing the name that the system is known by on a communica- 
tions network. 

New-name must be no longer than eight characters; longer names are trun- 
cated to eight. The old and new nodenames are printed on completion. 

EXAMPLE 

chgnod userlO /unix.current 

changes the nodename of /unix.current to userlO. 

SEE ALSO 

uname(2). 
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NAME 

chroot — change root directory for a command 

SYNOPSIS 

/etc/chroot newroot command 

DESCRIPTION 

The given command is executed relative to the new root. The meaning of 
any initial slashes (/) in path names is changed for a command and any of 
its children to newroot. Furthermore, the initial working directory is 
newroot. 

Notice that: 

chroot newroot command >x 

will create the file x relative to the original root, not the new one. 

This command is restricted to the super-user. 

The new root path name is always relative to the current root: even if a 
chroot is currently in effect, the newroot argument is relative to the current 
root of the running process. 

EXAMPLE 

chroot /users/asa Is /src 

will cause the command "Is /src" to list the directory "/users/asa/ src" since 
"/users/asa" is now effectively "/". 

SEE ALSO 

chdir(2). 

BUGS 

One should exercise extreme caution when referencing special files in the 
new root file system. 
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NAME 

clri — clear i-node 

SYNOPSIS 

/etc/clri file-system i-number ... 

DESCRIPTION 

Clri writes zeros on the 64 bytes occupied by the i-node numbered /- 
number. File-system must be a special file name referring to a device con- 
taining a file system. After clri is executed, any blocks in the affected file 
will show up as "missing" in an ^cAl(IM) of the file-system. This com- 
mand should only be used in emergencies and extreme care should be 
exercised. 

Read and write permission is required on the specified file-system device. 
The i-node becomes allocatable. 

The primary purpose of this routine is to remove a file which for some rea- 
son appears in no directory. If it is used to zap an i-node which does 
appear in a directory, care should be taken to track down the entry and 
remove it. Otherwise, when the i-node is reallocated to some new file, the 
old entry will still point to that file. At that point removing the old entry 
will destroy the new file. The new entry will again point to an unallocated 
i-node, so the whole cycle is likely to be repeated again and again. 

EXAMPLE 

clri /dev/yyyy n 

where "yyyy" is a legitimate system device name, and "n" is the inode 
number to be cleared, will cause inode numbered "n" for device 
"/dev/yyyy" to be cleared to 64-bytes of Os. Note: this instruction should 
only be used with caution. 

SEE ALSO 

fsck(lM), fsdb(lM), ncheck(lM), fs(4). 

BUGS 

If the file is open, clri is likely to be ineffective. 
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NAME 

cron — clock daemon 

SYNOPSIS 

/etc/cron 

DESCRIPTION 

Cron executes commands at specified dates and times according to the 
instructions in the file /usr/lib/crontab. Because cron never exits, it 
should be executed only once. This is best done by running cron from the 
initialization process through the file /etc/rc (see initilM)). 

The file crontab consists of lines of six fields each. The fields are separated 
by spaces or tabs. The first five are integer patterns that specify in order: 

minute (0-59), 

hour (0-23), 

day of the month (1-31), 

month of the year (1-12), 

and day of the week (0-6, with = Sunday). 

Each of these patterns may contain: 

a number in the (respective) range indicated above; 

two numbers separated by a minus (indicating an inclusive range) ; 

a list of numbers separated by commas (meaning all of these 

numbers); or 

an asterisk (meaning all legal values). 

The sixth field is a string that is executed by the shell at the specified 
time(s). A % in this field is translated into a new-line character. Only the 
first line (up to a % or the end of line) of the command field is executed by 
the shell. The other lines are made available to the command as standard 
input. 

Cron examines crontab once a minute to see if it has changed; if it has, 
cron reads it. Thus it takes only a minute for entries to become effective. 

EXAMPLE 

If the shell file /etc/rc contains the command line 

/etc/cron 

the clock daemon will be started every time /etc/rc is invoked, i.e., each 
time the system goes into multi-user mode after booting. 

FILES 

/usr/lib/crontab 
/ usr/ adm/ cronlog 

SEE ALSO 

init(lM), sh(l). 

DIAGNOSTICS 

A history of all actions by cron are recorded in /usr/adm/cronlog. 

BUGS 

Cron reads crontab only when it has changed, but it reads the in-core ver- 
sion of that table once a minute. A more efficient algorithm could be used. 
The overhead in running cron is about one percent of the CPU, exclusive of 
any commands executed by cron. 
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NAME 

dcopy — copy file systems for optimal access time 

SYNOPSIS 

/etc/dcopy [-sX] [-an] [-d] [-v] [-ffsize:isize] inputfs outputfs 

DESCRIPTION 

Dcopy copies file system inputfs to outputfs. Inputfs is the existing file sys- 
tem; outputfs is an appropriately sized file system, to hold the reorganized 
result. For best results inputfs should be the raw device and outputfs should 
be the block device. Dcopy should be run on unmounted file systems (in 
the case of the root file system, copy to a new pack). With no arguments, 
dcopy copies files from inputfs compressing directories by removing vacant 
entries, and spacing consecutive blocks in a file by the optimal rotational 
gap. The possible options are: 

— s A' supply device information for creating an optimal organization of 

blocks in a file. The forms of A' are the same as the — s option of 
fsckilM). 

— a« place the files not accessed in n days after the free blocks of the desti- 

nation file system (default for /; is 7). If no n is specified then no 
movement occurs. 

— d leave order of directory entries as is (default is to move sub- 

directories to the beginning of directories). 

— V currently reports how many files were processed, and how big the 

source and destination freelists are. 

— ffsizeUisize] 

specify the outputfs h\e system and inode list sizes (in blocks). If not 
given, the values from the inputfs are used. UniPlus"'".I Dcopy 
catches interrupts and quits and reports on its progress. To terminate 
dcopy, send a quit signal and dcopy will no longer catch interrupts or 
quits. Dcopy also attempts to modify its command line arguments so 
its progress can be monitored with ps(l). 

SEE ALSO 

fsck(lM), mkfs(lM), ps(l). 
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NAME 

devnm — device name 

SYNOPSIS 

/etc/devnm [names] 

DESCRIPTION 

Devnm identifies the special file associated with the mounted file system 
where the argument name resides (as a special case, both the block device 
name and the swap device name is printed for the argument name / if 
swapping is done on the same disk section as the root file system). Argu- 
ment names must be full path names. 

This command is most commonly used by /etc/rc (see brc{\M)) to con- 
struct a mount table entry for the root device. 

EXAMPLE 

/etc/devnm /usr 

produces 

rpl /usr 
if /usr is mounted on /dev/rpl. 



FILES 



/dev/rp*, /dev/dsk* 
/etc/mnttab 



SEE ALSO 

brc(lM), setmnt(lM). 
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NAME 

df — report number of free disk blocks 

SYNOPSIS 

df [ -t 1 [ -f ] [ file-systems ] 

DESCRIPTION 

Df prints out the number of free blocks and free i-nodes available for on- 
line file systems by examining the counts kept in the super-blocks; file- 
systems may be specified either by device name (e.g., /dev/dskl) or by 
mounted directory name (e.g., /usr). If the file-systems argument is 
unspecified, the free space on all of the mounted file systems is printed. 

The — t flag causes the total allocated block figures to be reported as well. 

If the — f flag is given, only an actual count of the blocks in the free list is 
made (free i-nodes are not reported). With this option, df mW report on 
raw devices. 



FILES 



/dev/dsk* 
/etc/mnttab 



SEE ALSO 

fs(4), mnttab(4). 
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NAME 

diskformat - format a disk 

SYNOPSIS 

diskformat [-size #] [-dens #] [-cyl f[-t]] [-sec f[-t]] [-i] #] device 

DESCRIPTION 

Diskformat initializes a hard disk or floppy disk and formats it according to 
your specifications. 

The following parameters may be specified ("device" is required): 

device device to be formatted (must be raw device) 

— size # specify sector size in bytes 

—dens # specify density 

— cyl #[-#! format cylinders /to t (default/). A specification such as 
#- means "until the end". 

— head #(-#1 Format heads /to t (default/). A specification such as #- 

means "until the end". 

— sec #[-#J Format sectors /to / (default /). A specification such as 

#- means "until the end". 

-il # Interleave factor for the disk. 

EXAMPLE 

diskformat /dev/rfdcO -dens 1 -size 128 -il 3 

will format the floppy disk on drive 0, single density, 128 bytes per sector 
with an interleave factor of 3. This format is the only truly portable floppy 
format. 



October 1983 



DISKTUNE(IM) (UniSoft) DISKTUNE(IM) 



NAME 

disktune - tune floppy disk settling time parameters 

SYNOPSIS 

disktune [-srt #] [-hit #] [-hut #] device 

DESCRIPTION 

Disktune tunes floppy disk settling time parameters. These include the 
motor stepping rate and the rate at which the head loads and unloads. 
Disktune thus enables you to obtain the most efficient operation from your 
floppy on those systems that support it. 

If no settable parameters are given, disktune will report the current settings 
on device. Disktune retains the current settings on parameters which are not 
specified. 

The raw device, /dev/rflop, must be specified. 

The settable parameters are: 

— srt # seek motor stepping rate time in milliseconds 

— hit # head loading time in milliseconds 

— hut # head unload time in milliseconds 

EXAMPLE 

disktune -srt 3 /dev/rfdcO 

will set the step rate time on the floppy controller to 3 ms per step. 
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NAME 

errdead — extract error records from dump 

SYNOPSIS 

/etc/errdead dumpfile [ namelist ] 

DESCRIPTION 

When hardware errors are detected by the system, an error record that con- 
tains information pertinent to the error is generated. If the error-logging 
daemon errdemonilM) is not active or if the system crashes before the 
record can be placed in the error file, the error information is held by the 
system in a local buffer. Errdead examines a system dump (or memory), 
extracts such error records, and passes them to errpti\y[) for analysis. 

The dumpfile specifies the file (or memory) that is to be examined. The 
system namelist is specified by namelist; if not given, /unix is used. 

FILES 

/unix system namelist 

/usr/bin/errpt analysis program 

/usr/tmp/errXXXXXX temporary file 

DIAGNOSTICS 

Diagnostics may come from either errdead or errpt. In either case, they are 
intended to be self-explanatory. 

SEE ALSO 

errdemon(lM), errpt(lM). 
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NAME 

errdemon — error-logging daemon 

SYNOPSIS 

/usr/Iib/errdemon [ file ] 

DESCRIPTION 

The error logging daemon errdemon collects error records from the operat- 
ing system by reading the special file /dev/error and places them in file. If 
file is not specified when the daemon is activated, /usr/adm/errfile is used. 
Note that file is created if it does not exist; otherwise, error records are 
appended to it, so that no previous error data is lost. No analysis of the 
error records is done by errdemon; that responsibility is left to errptilM). 
The error-logging daemon is terminated by sending it a software kill signal 
(see signaKD). Only the super-user may start the daemon, and only one 
daemon may be active at any time. 

FILES 

/dev/error source of error records 

/usr/adm/errfile repository for error records 

DIAGNOSTICS 

The diagnostics produced by errdemon are intended to be self-explanatory. 

SEE ALSO 

errpt(lM), errstop(lM), kill(l), err(7). 
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NAME 

errpt — process a report of logged errors 

SYNOPSIS 

errpt [ options ] [ files ] 

DESCRIPTION 

Errpt processes data collected by the error logging mechanism 
{errdemon{\}A)) and generates a report of that data. The default report is a 
summary of all errors posted in the files named. Options apply to all files 
and are described below. If no files are specified, errpt attempts to use 
/usr/adm/errfile as file. 

A summary report notes the options that may limit its completeness, 
records the time stamped on the earliest and latest errors encountered, and 
gives the total number of errors of one or more types. Each device sum- 
mary contains the total number of unrecovered errors, recovered errors, 
errors unabled to be logged, I/O operations on the device, and miscellane- 
ous activities that occurred on the device. The number of times that errpt 
has difficulty reading input data is included as read errors. 

Any detailed report contains, in addition to specific error information, all 
instances of the error logging process being started and stopped, and any 
time changes (via dated)) that took place during the interval being pro- 
cessed. A summary of each error type included in the report is appended 
to a detailed report. 

A report may be limited to certain records in the following ways: 

— s date Ignore all records posted earlier than date, where date has the 

form mmddhhmmyy, consistent in meaning with the dated) 
command. 

— e date Ignore all records posted later than date, whose form is as 

described above. 

— a Produce a detailed report that includes all error types. 

— d devlist A detailed report is limited to data about devices given in 

devlist, where devlist can be one of two forms: a list of device 
identifiers separated from one another by a comma, or a list 
of device identifiers enclosed in double quotes and separated 
from one another by a comma and/or more spaces. Errpt is 
familiar with the common form of identifiers (see Section 7 of 
this volume). The devices for which errors are logged are 
system dependent. Additional identifiers are int and mem 
which include detailed reports of stray-interrupt and 
memory-parity type errors respectively. 

— p rt Limit the size of a detailed report to n pages. 

— f In a detailed report, limit the reporting of block device errors 

to unrecovered errors. 



FILES 



/usr/adm/errfile default error file 



SEE ALSO 

errdemon(lM), errfile(4). 
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NAME 

errstop — terminate the error-logging daemon 

SYNOPSIS 

/etc/errstop [ namelist ] 

DESCRIPTION 

The error-logging daemon errdemon (IM) is terminated by using errstop. 
This is accomplished by executing ps(\) to determine the daemon's iden- 
tity and then sending it a software kill signal (see signalO)); /unix is used 
as the system namelist if none is specified. Only the super-user may use 
errstop. 

FILES 

/unix default system namelist 

DIAGNOSTICS 

The diagnostics produced by errstop are intended to be self-explanatory. 

SEE ALSO 

errdemon (IM), ps(l), kill (2). 
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NAME 

ff — list file names and statistics for a file system 

SYNOPSIS 

/etc/ff [options] special 

DESCRIPTION 

Ff reads the i-list and directories of the special file, assuming it to be a file 
system, saving i-node data for files which match the selection criteria. Out- 
put consists of the path name for each saved i-node, plus any other file 
information requested using the print options below. Output fields are posi- 
tional. The output is produced in i-node order; fields are separated by tabs. 
The default line produced by #is: 

path-name i-number 

With all options enabled, output fields would be: 

path-name i-number size uid 

The argument n in the option descriptions that follow is used as a decimal 
integer (optionally signed), where +n means more than n, — n means less 
than n, and n means exactly n. A day is defined as a 24 hour period. 

— I Do not print the i-node number after each path name. 

-1 Generate a supplementary list of all path names for multiply 

linked files. 

-p prefix The specified prefix will be added to each generated path 
name. The default is .. 

— s Print the file size, in bytes, after each path name. 
-u Print the owner's login name after each path name. 

— an Select if the i-node has been accessed in n days. 

— m n Select if the i-node has been modified in n days. 
-en Select if the i-node has been changed in n days. 

— n file Select if the i-node has been modified more recently than the 

argument file. 

— i i-node-list 

Generate names for only those i-nodes specified in i-node-list. 

EXAMPLE 

ff — I /dev/diskroot 

generates a list of the names of all files on a specified file system. 

ff — m —1 /dev/diskusr > /log/incbackup/usr/tuesday 

produces an index of files and i-numbers which are on a file system and 
have been modified in the last 24 hours. 

ff -i 451,76 /dev/rrp7 

obtains the path names for i-nodes 451 and 76 on a specified file system. 

SEE ALSO 

finc(lM), find(l), frec(lM), ncheck(lM). 

BUGS 

Only a single path name out of any possible ones will be generated for a 
multiply linked i-node, unless the -1 option is specified. When -1 is 
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specified, no selection criteria apply to the names generated. All possible 
names for every linked file on the file system will be included in the output. 

On very large file systems, memory may run out before #does. 
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NAME 

filesave, tapesave — daily/weekly UNIX file system backup 

SYNOPSIS 

/etc/filesave. ? 
/etc/tapesave 

DESCRIPTION 

These shell scripts are provided as models. They are designed to provide a 
simple, interactive operator environment for file backup. Filesave. ? is for 
daily disk-to-disk backup and tapesave is for weekly disk-to-tape. 

The suffix .? can be used to name another system where two (or more) 
machines share disk drives (or tape drives) and one or the other of the sys- 
tems is used to perform backup on both. 

SEE ALSO 

shutdown (IM), volcopy(lM). 
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NAME 

fine — fast incremental backup 

SYNOPSIS 

fine [selection-criteria] file-system raw-tape 

DESCRIPTION 

Fine selectively copies the input file-system to the output raw-tape. The cau- 
tious will want to mount the input file-system read-only to insure an accu- 
rate backup, although acceptable results can be obtained in read-write 
mode. The tape must be previously labelled by labelit (see volcopyilM)) . 
The selection is controlled by the selection-criteria, accepting only those 
inodes/files for whom the conditions are true. 

It is recommended that production of a fine tape be preceded by the ^com- 
mand, and the output of #be saved as an index of the tape's contents. 
Files on a fine tape may be recovered with the free command. 

The argument n in the selection-criteria which follow is used as a decimal 
integer (optionally signed), where +n means more than n, — n means less 
than n, and n means exactly n. A day is defined as a 24 hours. 

— an True if the file has been accessed in n days. 

— m rt True if the file has been modified in n days. 

— en True if the i-node has been changed in n days. 

— n file True for any file which has been modified more recently than the 

argument file. 

EXAMPLE 

fine — m —2 /dev/rdiskusr /dev/rtpO 

writes a tape consisting of all files from file-system /usr modified in the last 
48 hours. 

SEE ALSO 

cpio(l), fr(lM), frec(lM), volcopy(lM). 
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NAME 

free — recover files from a backup tape 

SYNOPSIS 

/etc/free [-p path] [-f reqfile] raw-tape i-number:name ... 

DESCRIPTION 

Free recovers files from the specified raw-tape backup tape written by 
vo/co/>y(lM) or ^nc(lM), given their i-numbers. The data for each recovery 
request will be written into the file given by name . 

The — p option allows you to specify a default prefixing path different from 
your current working directory. This will be prefixed to any names that are 
not fully qualified, i.e. that do not begin with / or ./. If any directories are 
missing in the paths of recovery names they will be created. 

— p path Specifies a prefixing path to be used to fully qualify any names 

that do not start with / or ./. 

— f reqfile Specifies a file which contains recovery requests. The format is i- 

number:newname, one per line. 

EXAMPLE 

free /dev/rmtO 1216:junk 

recovers a file, i-number 1216 when backed-up, into a file named junk in 
your current working directory. 

free — p /usr/src/cmd /dev/rmtO 14156:a 1232:b 
3141:/usr/joe/a.c 

recovers files with i-numbers 14156, 1232, and 3141 into files 
/usr/src/cmd/a, /usr/src/cmd/b and /usr/joe/a.c. 

SEE ALSO 

cpio(l), ff(lM), fine(lM), volcopy(lM). 

BUGS 

While paving a path (i.e. creating the intermediate directories contained in a 
pathname) free can only recover inode fields for those directories contained 
on the tape and requested for recovery. 
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NAME 

fsck, dfsck — file system consistency check and interactive repair 

SYNOPSIS 

/etc/fsck [-y] [-n] [-sX] [-SX] [-t file] [-q] [-D] [-fl [file- 
systems 1 

/etc/dfsck [ options 1 ] filsysl . . . — [ options2 ] filsys2 . . . 

DESCRIPTION 
Fsck 

Fsck audits and interactively repairs inconsistent conditions for UNIX Sys- 
tem files. If the file system is consistent then the number of files, number 
of blocks used, and number of blocks free are reported. If the file system 
is inconsistent the operator is prompted for concurrence before each correc- 
tion is attempted. It should be noted that most corrective actions will result 
in some loss of data. The amount and severity of data lost may be deter- 
mined from the diagnostic output. The default action for each consistency 
correction is to wait for the operator to respond yes or no. If the operator 
does not have write permission fsck will default to a — n action. 

Fsck has more consistency checks than its predecessors check, dcheck, 
/check, and icheck combined. 

The following options are interpreted by fsck. 

— y Assume a yes response to all questions asked by fsck. 

— n Assume a no response to all questions asked by fsck; do not open 

the file system for writing. 

— sX Ignore the actual free list and (unconditionally) reconstruct a new 

one by rewriting the super-block of the file system. The file system 
should be unmounted while this is done; if this is not possible, care 
should be taken that the system is quiescent and that it is rebooted 
immediately afterwards. This precaution is necessary so that the old, 
bad, in-core copy of the superblock will not continue to be used, or 
written on the file system. 

The —s Adoption allows for creating an optimal free-list organization. 
The following forms of X are supported for the following devices: 

-s3 (RP03) 

-s4 (RP04, RP05, RP06) 

— sBlocks-per-cylinder:Blocks-to-skip (for anything else) 

If X is not given, the values used when the file system was created 
are used. If these values were not specified, then the value 400: 7 is 
used. 

— SX Conditionally reconstruct the free list. This option is like —sZ above 

except that the free list is rebuilt only if there were no discrepancies 
discovered in the file system. Using — S will force a no response to 
all questions asked by fsck. This option is useful for forcing free list 
reorganization on uncontaminated file systems. 

— t If fsck cannot obtain enough memory to keep its tables, it uses a 

scratch file. If the - 1 option is specified, the file named in the next 
argument is used as the scratch file, if needed. Without the -t flag, 
fsck will prompt the operator for the name of the scratch file. The 
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file chosen should not be on the file system being checked, and if it 
is not a special file or did not already exist, it is removed when fsck 
completes. 

— q Quiet fsck. Do not print size-check messages in Phase 1. Unrefer- 

enced fifos will silently be removed. \{ fsck requires it, counts in the 
superblock will be automatically fixed and the free list salvaged. 

— D Directories are checked for bad blocks. Useful after system crashes. 

-f Fast check. Check block and sizes (Phase 1) and check the free list 
(Phase 5). The free list will be reconstructed (Phase 6) if it is neces- 
sary. 

If no file-systems are specified, fsck will read a list of default file systems 
from the file /etc/checklist. 

Inconsistencies checked are as follows: 

1 . Blocks claimed by more than one inode or the free list. 

2. Blocks claimed by an inode or the free list outside the range of 
the file system. 

3. Incorrect link counts. 

4. Size checks: 

Incorrect number of blocks. 
Directory size not 16-byte aligned. 

5. Bad inode format. 

6. Blocks not accounted for anywhere. 

7. Directory checks: 

File pointing to unallocated inode. 
Inode number out of range. 

8. Super Block checks: 

More than 65536 inodes. 

More blocks for inodes than there are in the file system. 

9. Bad free block list format. 

10. Total free block and/ or free inode count incorrect. 

Orphaned files and directories (allocated but unreferenced) are, with the 
operator's concurrence, reconnected by placing them in the lost + found 
directory, if the files are nonempty. The user will be notified if the file or 
directory is empty or not. If it is empty, fsck will silently remove them. 
Fsck will force the reconnection of nonempty directories. The name 
assigned is the inode number. The only restriction is that the directory 
lost -J- found must preexist in the root of the file system being checked and 
must have empty slots in which entries can be made. This is accomplished 
by making lost -H found, copying a number of files to the directory, and then 
removing them (before ^c/c is executed). 

Checking the raw device is almost always faster and should be used with 
everything but the roo/ file system. 

Dfsck 

Dfsck allows two file system checks on two different drives simultaneously. 
optionsl and options! are used to pass options to fsck for the two sets of file 
systems. A — is the separator between the file system groups. 

The dfsck program permits an operator to interact with two fsckiXM) pro- 
grams at once. To aid in this, dfsck will print the file system name for each 
message to the operator. When answering a question from dfsck, the 
operator must prefix the response with a 1 or a 2 (indicating that the 
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answer refers to the first or second file system group). 
Do not use dfsck to check the root file system. 

EXAMPLE 

fsck /dev/rdiskO 

checks the consistency of device rdiskO. 

FILES 

/etc/ checklist contains default list of file systems to check. 

SEE ALSO 

clri(lM), ncheck(lM), checklist(4), fs(4), crash(8). 
Setting up the UNIX System 

BUGS 

Inode numbers for . and . . in each directory should be checked for validity. 

DIAGNOSTICS 

The diagnostics produced by fsck are intended to be self-explanatory. 

WARNING 

There are some areas that can only be corrected on a raw device with no 
sync. Some devices which are in use such as /dev/console, /dev/systty, 
/dev/syscon will not be corrected by fsck. 
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NAME 

fsdb — file system debugger 

SYNOPSIS 

/etc/fsdb special [ — ] 

DESCRIPTION 

Fsdb can be used to patch up a damaged file system after a crash. It has 
conversions to translate block and i-numbers into their corresponding disk 
addresses. Also included are mnemonic offsets to access different parts of 
an i-node. These greatly simplify the process of correcting control block 
entries or descending the file system tree. 

Fsdb contains several error checking routines to verify i-node and block 
addresses. These can be disabled if necessary by invoking fsdb with the 
optional — argument or by the use of the O symbol. (Fsdb reads the i-size 
and f-size entries from the superblock of the file system as the basis for 
these checks.) 

Numbers are considered decimal by default. Octal numbers must be 
prefixed with a zero. During any assignment operation, numbers are 
checked for a possible truncation error due to a size mismatch between 
source and destination. 

Fsdb reads a block at a time and will therefore work with raw as well as 
block I/O. A buffer management routine is used to retain commonly used 
blocks of data in order to reduce the number of read system calls. All 
assignment operations result in an immediate write-through of the 
corresponding block. 

The symbols recognized by fsdb are: 

# absolute address 

i convert from i-number to i-node address 

b convert to block address 

d directory slot offset 

+ , — address arithmetic 

q quit 

>,< save, restore an address 

= numerical assignment 

= + incremental assignment 

== — decremental assignment 

= " character string assignment 

O error checking flip flop 

p general print facilities 

f file print facility 

B byte mode 

W word mode 

D double word mode 

! escape to shell 

The print facilities generate a formatted output in various styles. The 
current address is normalized to an appropriate boundary before printing 
begins. It advances with the printing and is left at the address of the last 
item printed. The output can be terminated at any time by typing the 
delete character. If a number follows the p symbol, that many entries are 
printed. A check is made to detect block boundary overflows since logically 
sequential blocks are generally not physically sequential. If a count of zero 
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is used, all entries to the end of the current block are printed. The print 
options available are: 

i print as i-nodes 

d print as directories 

o print as octal words 

e print as decimal words 

c print as characters 

b print as octal bytes 

The f symbol is used to print data blocks associated with the current i- 
node. If followed by a number, that block of the file is printed. (Blocks 
are numbered from zero.) The desired print option letter follows the block 
number, if present, or the f symbol. This print facility works for small as 
well as large files. It checks for special devices and that the block pointers 
used to find the data are not zero. 

Dots, tabs and spaces may be used as function delimiters but are not neces- 
sary. A line with just a new-line character will increment the current 
address by the size of the data type last printed. That is, the address is set 
to the next byte, word, double word, directory entry or i-node, allowing the 
user to step through a region of a file system. Information is printed in a 
format appropriate to the data type. Bytes, words and double words are 
displayed with the octal address followed by the value in octal and decimal. 
A .B or .D is appended to the address for byte and double word values, 
respectively. Directories are printed as a directory slot offset followed by 
the decimal i-number and the character representation of the entry name. 
Inodes are printed with labeled fields describing each element. 

The following mnemonics are used for i-node examination and refer to the 
current working i-node: 



12) 



EXAMPLE 

386i prints i-number 386 in an i-node format. This now becomes the 
current working i-node. 

In =4 changes the link count for the working i-node to 4. 

ln=-l-l 

increments the link count by 1 . 

fc prints, in ASCII, block zero of the file associated with the working 

i-node. 

2i.fd prints the first 32 directory entries for the root i-node of this file 
system. 

dSi.fc changes the current i-node to that associated with the 5th directory 
entry (numbered from zero) found from the above command. The 
first logical block of the file is then printed in ASCII. 
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md 


mode 


In 


link count 


uid 


user ID number 


gid 


group ID number 


sz 


file size 


a# 


data block numbers (0 — 


at 


access time 


mt 


modification time 


maj 


major device number 


min 


minor device number 
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512B.pOo 

prints the superblock of this file system in octal. 

2i.aOb.d7 = 3 

changes the i-number for the seventh directory slot in the root 
directory to 3. This example also shows how several operations can 
be combined on one command line. 

d7.nm="name" 

changes the name field in the directory slot to the given string. 
Quotes are optional when used with nm if the first character is 
alphabetic. 

a2b.pOd 

prints the third block of the current inode as directory entries. 

SEE ALSO 

fsck(lM), dir(4), fs(4). 
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NAME 

fuser — identify processes using a file or file structure 

SYNOPSIS 

/etc/fuser [-ku] files [-] [[-ku] files] 

DESCRIPTION 

Fuser lists the process IDs of the processes using the files specified as argu- 
ments. For block special devices, all processes using any file on that device 
are listed. The process ID is followed by c, p or r if the process is using the 
file as its current directory, the parent of its current directory (only when in 
use by the system), or its root directory, respectively. If the — u option is 
specified, the login name, in parentheses, also follows the process ID. In 
addition, if the — k option is specified, the SIGKILL signal is sent to each 
process. Only the super-user can terminate another user's process (see 
killil)). Options may be respecified between groups of files. The new set 
of options replaces the old set, with a lone dash canceling any options 
currently in force. 

The process IDs are printed as a single line on the standard output, 
separated by spaces and terminated with a single new line. All other output 
is written on standard error. 

EXAMPLE 

fuser — ku /dev/dskl? 

will terminate all processes that are preventing disk drive one from 
being unmounted if typed by the super-user, listing the process ID and 
login name of each as it is killed. 

fuser — u /etc/passwd 

will list process IDs and login names of processes that have the password 
file open. 

fuser — ku /dev/dskl? — u /etc/passwd 

will do both of the above examples in a single command line. 

Note that the device names for disks are system dependent. 

FILES 

/unix for namelist 

/dev/kmem for system image 

/dev/mem also for system image 

SEE ALSO 

mount(lM), ps(l), kill(2), signal(2). 
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NAME 

fwtmp, wtmpfix — manipulate connect accounting records 

SYNOPSIS 

/usr/lib/acct/fwtmp [-icl 
/usr/lib/acct/wtmpfix [files] 

DESCRIPTION 
Fwtmp 

Fwtmp reads from the standard input and writes to the standard output, 
converting binary records of the type found in wtmp to formated ASCII 
records. The ASCII version is useful to enable editing, via ed(\), bad 
records or general purpose maintenance of the file. 

The argument -ic is used to denote that input is in ASCII form, and output 
is to be written in binary form. 

Wtmpfix 

Wtmpfix examines the standard input or named files in wtmp format, 
corrects the time/ date stamps to make the entries consistent, and writes to 
the standard output. A — can be used in place of files to indicate the stan- 
dard input. If time/ date corrections are not performed, acctconl will fault 
when it encounters certain date change records. 

Each time the date is set, a pair of date change records are written to 
/etc/wtmp. The first record is the old date denoted by the string old time 
placed in the line field and the flag OLD_TIME placed in the type field of 
the <utmp.h> structure. The second record specifies the new date and is 
denoted by the string new time placed in the line field and the flag 
NEW_TIME placed in the type field. Wtmpfix uses these records to syn- 
chronize all time stamps in the file. 

In addition to correcting time/ date stamps, wtmpfix will check the validity of 
the name field to ensure that it consists solely of alphanumeric characters, a 
$ or spaces. If it encounters a name that is considered invalid, it will 
change the login name to INVALID and write a diagnostic to the standard 
error. In this way, wtmpfix reduces the chance that acctconl will fail when 
processing connect accounting records. 

FILES 

/etc/wtmp 

/usr/ include/ utmp.h 

SEE ALSO 

acct(lM), acctcms(lM), acctcom(I), acctcon(IM), acctmerg(lM), 
acctprc(lM), acctsh(lM), runacct(lM), acct(2), acct(4), utmp(4). 
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NAME 

getty — set terminal type, modes, speed, and line discipline 

SYNOPSIS 

/etc/getty [ — h ] [ — t timeout 1 line [ speed [ type [ linedisc ] 1 1 
/etc/getty -c file 

DESCRIPTION 

Getty is a program that is invoked by //i/Y(lM). It is the second process in 
the series, (init-getty-login-shell) that ultimately connects a user with the 
UNIX System. Initially getty prints the login message field for the entry it is 
using from /etc/gettydefs. Getty reads the user's login name and invokes 
the loginil) command with the user's name as argument. While reading 
the name, getty attempts to adapt the system to the speed and type of ter- 
minal being used. 

Line is the name of a tty line in /dev to which getty is to attach itself. Getty 
uses this string as the name of a file in the /dey directory to open for read- 
ing and writing. Unless getty is invoked with the — h flag, getty will force a 
hangup on the line by setting the speed to zero before setting the speed to 
the default or specified speed. The — t flag plus timeout in seconds, 
specifies that getty should exit if the open on the line succeeds and no one 
types anything in the specified number of seconds. The optional second 
argument, speed, is a label to a speed and tty definition in the file 
/etc/gettydefs. This definition tells getty vfhat speed to initially run at, what 
the login message should look like, what the initial tty settings are, and 
what speed to try next should the user indicate that the speed is inappropri- 
ate. (By typing a < break> character.) The default speed is 300 baud. The 
optional third argument, type, is a character string describing to getty what 
type of terminal is connected to the line in question. Getty understands the 
following types: 

none default 

vt61 DEC vt61 

vtlOO DEC vtlOO 

hp45 Hewlett-Packard HP45 

clOO Concept 100 

The default terminal is nonep; i.e., any crt or normal terminal unknown to 
the system. Also, for terminal type to have any meaning, the virtual termi- 
nal handlers must be compiled into the operating system. They are avail- 
able, but not compiled in the default condition. The optional fourth argu- 
ment, linedisc, is a character string describing which line discipline to use in 
communicating with the terminal. Again the hooks for line disciplines are 
available in the operating system but there is only one presently available, 
the default line discipline, LDISCO. 

When given no optional arguments, getty sets the speed of the interface to 
300 baud, specifies that raw mode is to be used (awaken on every charac- 
ter), that echo is to be suppressed, either parity allowed, newline characters 
will be converted to carriage return-line feed, and tab expansion performed 
on the standard output. It types the login message before reading the 
user's name a character at a time. If a null character (or framing error) is 
received, it is assumed to be the result of the user pushing the "break" 
key. This will cause getty to attempt the next speed in the series. The series 
that getty tries is determined by what it finds in /etc/gettydefs. 
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The user's name is terminated by a new-line or carriage-return character. 
The latter results in the system being set to treat carriage returns appropri- 
ately (see ioctlil)). 

The user's name is scanned to see if it contains any lower-case alphabetic 
characters; if not, and if the name is non-empty, the system is told to map 
any future upper-case characters into the corresponding lower-case charac- 
ters. 

Finally, login is called with the user's name as an argument. Additional 
arguments may be typed after the login name. These are passed to login, 
which will place them in the environment (see loginil)). 

A check option is provided. When getty is invoked with the — c option and 
file, it scans the file as if it were scanning /etc/gettydefs and prints out the 
results to the standard output. If there are any unrecognized modes or 
improperly constructed entries, it reports these. If the entries are correct, it 
prints out the values of the various flags. See ioctl{2) to interpret the 
values. Note that some values are added to the flags automatically. 



FILES 



/etc/gettydefs 



SEE ALSO 

ct(lC), init(lM), login(l), ioctl(2), gettydefs(4), inittab(4), tty(7). 
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NAME 

init, telinit — process control initialization 

SYNOPSIS 

/etc/init [0123456SsQq] 

/etc/telinit [0123456sSQqabc] 

DESCRIPTION 
Init 

Init is a general process spawner. Its primary role is to create processes from 
a script stored in the file /etc/inittab (see inittabi4)) . This file usually has 
init spawn getty^s on each line that a user may log in on. It also controls 
autonomous processes required by any particular system. 

Init considers the system to be in a run-level at any given time. A run-level 
can be viewed as a software configuration of the system where each 
configuration allows only a selected group of processes to exist. The 
processes spawned by init for each of these run-levels is defined in the inittab 
file. /rt/Ycan be in one of eight run-levels, — 6 and S or s. The run-level '\s 
changed by having a privileged user run /etc/init (which is linked to 
/etc/telinit). This user spawned /«// sends appropriate signals to the orginal 
init spawned by the operating system when the system was rebooted, telling 
it which run-level to change to. 

Init is invoked inside the UNIX System as the last step in the boot pro- 
cedure. The first thing init does is to look for /etc/inittab and see if there 
is an entry of the type initdefault (see inittab(4)). If there is, init uses the 
run-level specified in that entry as the initial run-level to enter. If this entry 
is not in inittab or inittab is not found, init requests that the user enter a 
run-level from the virtual system console, /dev/syscon. If an S (s) is 
entered, init goes into the SINGLE USER level. This is the only run-level that 
doesn't require the existence of a properly formatted inittab file. If 
/etc/inittab doesn't exist, then by default the only legal run-level that init 
can enter is the SINGLE USER level. In the SINGLE USER level the virtual 
console terminal /dev/syscon is opened for reading and writing and the 
command /bin/su is invoked immediately. To exit from the SINGLE USER 
run-level one of two options can be elected. First, if the shell is terminated 
(via an end-of-file), init y/ill reprompt for a new run-level. Second, the init 
or telinit command can signal init and force it to change the run-level of the 
system. 

When attempting to boot the system, failure of init to prompt for a new 
run-level may be due to the fact that the device /dev/syscon is linked to a 
device other than the physical system teletype (/dev/systty) . If this 
occurs, init can be forced to relink /dev/syscon by typing a delete on the 
system teletype which is co-located with the processor. 

When init prompts for the new run-level, the operator may only enter one 
of the digits through 6 or the letters S or s. If S is entered init operates 
as previously described in SINGLE USER mode with the additional result 
that /dev/syscon is linked to the user's terminal line, thus making it the 
virtual system console. A message is generated on the physical console, 
/dev/systty, saying where the virtual terminal has been relocated. 

When init comes up initially and whenever it switches out of SINGLE USER 
state to normal run states, it sets the ioctl(2) states of the virtual console, 
/dev/syscon, to those modes saved in the file /etc/ioctl.syscon. This file is 
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written by init whenever SINGLE USER mode is entered. If this file doesn't 
exist when init wants to read it, a warning is printed and default settings are 
assumed. 

If a through 6 is entered init enters the corresponding run-level. Any 
other input will be rejected and the user will be re-prompted. If this is the 
first time init has entered a run-level other than SINGLE USER, init first scans 
inittab for special entries of the type boot and bootwait. These entries are 
performed, providing the run-level entered matches that of the entry before 
any normal processing of inittab takes place. In this way any special initiali- 
zation of the operating system, such as mounting file systems, can take 
place before users are allowed onto the system. The inittab file is scanned 
to find all entries that are to be processed for that run-level. 

Run-level 2 is usually defined by the user to contain all of the terminal 
processes and daemons that are spawned in the multi-user environment. 

In a multi-user environment, the inittab file is usually set up so that init will 
create a process for each terminal on the system. 

For terminal processes, ultimately the shell will terminate because of an 
end-of-file either typed explicitly or generated as the result of hanging up. 
When init receives a child death signal, telling it that a process it spawned 
has died, it records the fact and the reason it died in /etc/utmp and 
/etc/wtmp if it exists (see whoil)). A history of the processes spawned is 
kept in /etc/wtmp if such a file exists. 

To spawn each process in the inittab file, init reads each entry and for each 
entry which should be respawned, it forks a child process. After it has 
spawned all of the processes specified by the inittab file, init waits for one of 
its descendant processes to die, a powerfail signal, or until init is signaled by 
init or telinit to change the system's run-level. When one of the above three 
conditions occurs, init re-examines the inittab file. New entries can be 
added to the inittab file at any time; however, init still waits for one of the 
above three conditions to occur. To provide for an instantaneous response 
the init Q or init q command can wake initio re-examine the inittab file. 

If init receives a powerfail signal {SIGPWR) and is not in SINGLE USER 
mode, it scans inittab for special powerfail entries. These entries are 
invoked (if the run-levels permit) before any further processing takes place. 
In this way init can perform various cleanup and recording functions when- 
ever the operating system experiences a power failure. It is important to 
note that the powerfail entries should not use devices that must first be ini- 
tialized (e.g. dzb lines) after a power failure has occurred. 

When init is requested to change run-levels, (via telinii) , init sends the warn- 
ing signal (SIGTERM) to all processes that are undefined in the target run- 
level. Init waits 20 seconds before forcibly terminating these processes via 
the kill signal (SIGKILL). 

Telinit 

Telinit, which is linked to /etc/init, is used to direct the actions of init. It 
takes a one character argument and signals init via the kill system call to 
perform the appropriate action. The following arguments serve as direc- 
tives to init. 

— 6 tells initio place the system in one of the run-levels^ — 6. 
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a,b,c 

tells init to process only those /etc/inittab file entries having the 
a, b or c run-level set. 

Q,q tells init to re-examine the /etc/inittab file. 

s,S tells init to enter the single user environment. When this level 
change is effected, the virtual system teletype, /dev/syscon, is 
changed to the terminal from which the command was executed. 

Telinit can only be run by someone who is super-user or a member of 
group sys. 



FILES 



/etc/inittab 

/etc/utmp 

/etc/wtmp 

/etc/ioctl.syscon 

/dev/syscon 

/dev/systty 

SEE ALSO 

getty(lM), login (1), sh(l), who(l), kill (2), inittab(4), utmp(4). 

DIAGNOSTICS 

If init finds that it is continuously respawning an entry from /etc/inittab 
more than 10 times in 2 minutes, it will assume that there is an error in the 
command string, and generate an error message on the system console, and 
refuse to respawn this entry until either 5 minutes has elapsed or it receives 
a signal from a user init (telinit). This prevents init {rom eating up system 
resources when someone makes a typographical error in the inittab file or a 
program is removed that is referenced in the inittab. 
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NAME 

install — install commands 

SYNOPSIS 

/etc/install [-c dira] [-f dirb] [-i] [-n dire] [-o] [-si file [dirx 

DESCRIPTION 

Install is a command most commonly used in "makefiles" (see make (l)) to 
install a file (updated target file) in a specific place within a file system. 
Each file is installed by copying it into the appropriate directory, thereby 
retaining the mode and owner of the original command. The program 
prints messages telling the user exactly what files it is replacing or creating 
and where they are going. 

If no options or directories (dirx . . .) are given, install will search a set of 
default directories (/bin, /usr/bin, /etc, /lib, and /usr/lib, in that order) 
for a file with the same name as file. When the first occurrence is found, 
install issues a message saying that it is overwriting that file with file, and 
proceeds to do so. If the file is not found, the program states this and exits 
without further action. 

If one or more directories (dirx . . .) are specified after file, those directories 
will be searched before the directories specified in the default list. 

The meanings of the options are: 

— cdira Installs a new command (file) in the directory specified by dira, 

only if it is not found. If it is found, install issues a message say- 
ing that the file already exists, and exits without overwriting it. 
May be used alone or with the - s option. 

— idirb Forces file to be installed in given directory, whether or not one 

already exists. If the file being installed does not already exist, the 
mode and owner of the new file will be set to 755 and bin, respec- 
tively. If the file already exists, the mode and owner will be that 
of the already existing file. May be used alone or with the - o or 
-s options. 

-i Ignores default directory list, searching only through the given 

directories (dirx ...). May be used alone or with any other 
options other than — c and — f. 

— n dire If file is not found in any of the searched directories, it is put in 

the directory specified in dire. The mode and owner of the new 
file will be set to 755 and bin, respectively. May be used alone or 
with any other options other than - c and - f . 

-0 If file is found, this option saves the "found" file by copying it to 

OLBfile in the directory in which it was found. This option is use- 
ful when installing a normally text busy file such as /bin/sh or 
/etc/getty, where the existing file cannot be removed. May be 
used alone or with any other options other than — c. 

— s Suppresses printing of messages other than error messages. May 

be used alone or with any other options. 

SEE ALSO 

make(l). 
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NAME 

killall — kill all active processes 

SYNOPSIS 

/etc/killall [ signal ] 

DESCRIPTION 

Killall is is a procedure used by /etc/shutdown to kill all active processes 
not directly related to the shut down procedure. 

Killall is chiefly used to terminate all processes with open files so that the 
mounted file systems will be unbusied and can be unmounted. 

Killall sends signal (see killil)) to all remaining processes not belonging to 
the above group of exclusions. If no signal is specified, a default of 9 is 
used. 

FILES 

/etc/shutdown 

SEE ALSO 

fuser(lM), kill(l), ps(l), shutdown(lM), signal(2). 
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NAME 

link, unlink — exercise link and unlink system calls 

SYNOPSIS 

/etc/link filel file2 
/etc/unlink file 

DESCRIPTION 

Link and unlink perform their respective system calls on their arguments, 
abandoning all error checking. These commands may only be executed by 
the super-user, who (it is hoped) knows what he or she is doing. 

EXAMPLE 

link filel file2 

creates a directory entry for "file2" with the same inode number as "filel". 
NOTE: link should be used with extreme caution. 

SEE ALSO 

rm(l), link(2), unlink(2). 
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NAME 

Ipadmin — configure the LP spooling system 

SYNOPSIS 

/usr/lib/lpadmin —p printer [options] 

/usr/lib/lpadmin — x dest 

/usr/lib/lpadmin -d[dest] 

DESCRIPTION 

Lpadmin configures LP spooling systems to describe printers, classes and 
devices. It is used to add and remove destinations, change membership in 
classes, change devices for printers, change printer interface programs and 
to change the system default destination. Lpadmin may not be used when 
the LP scheduler, IpschedilM) , is running, except where noted below. 

Exactly one of the — p, — d or — x options must be present for every legal 
invocation of Ipadmin. 

-dirfesd makes dest, an existing destination, the new system default 

destination. If dest is not supplied, then there is no system 
default destination. This option may be used when 
IpschediXM) is running. No other options are allowed with 
-d. 

— xdest removes destination dest from the LP system. If dest is a 

printer and is the only member of a class, then the class will 
be deleted, too. No other options are allowed with — x. 

—pprinter names a printer to which all of the options below refer. If 
printer does not exist then it will be created. 

The following options are only useful with — p and may appear in any order. 
For ease of discussion, the printer will be referred to as P below. 

—cclass inserts printer Pinto the specified class. Class will be created 

if it does not already exist. 

—e printer copies an existing printer's interface program to be the new 
interface program for P. 

— h indicates that the device associated with Pis hardwired. This 

option is assumed when creating a new printer unless the - 1 
option is supplied. 

— i interface establishes a new interface program for P. Interface is the 

path name of the new program. 

- 1 indicates that the device associated with P is a login terminal. 

The LP scheduler, Ipsched, disables all login terminals 
automatically each time it is started. Before re-enabling P, 
its current device should be established using Ipadmin. 

— m model selects a model interface program for P. Modeiis one of the 

model interface names supplied with the LP software (see 
Models below) . 

— T class removes printer P from the specified class. If Pis the last 

member of the class, then the class will be removed. 

—y device associates a new device with printer P. Device is the path- 
name of a file that is writable by the LP administrator, Ip. 
Note that there is nothing to stop an administrator from 
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associating the same device with more than one printer. If 
only the - p and - v options are supplied, then Ipadmin may 
be used while the scheduler is running. 

Restrictions. 

When creating a new printer, the — v option and one of the — e, — i or — m 
options must be supplied. Only one of the — e, — i or — m options may be 
supplied. The — h and —I keyletters are mutually exclusive. Printer and 
class names may be no longer than 14 characters and must consist entirely 
of the characters A-Z, a-z, 0-9 and _ (underscore). 

Models. 

Model printer interface programs are supplied with the LP software. They 
are shell procedures which interface between Ipsched and devices. All 
models reside in the directory /usr/spool/lp/model and may be used as is 
with Ipadmin — m. Alternatively, LP administrators may modify copies of 
models and then use Ipadmin — i to associate them with printers. The fol- 
lowing list describes the models and lists the options which they may be 
given on the //» command line using the — o keyletter: 

dumb interface for a line printer without special functions and protocol. 
Form feeds are assumed. This is a good model to copy and modify 
for printers which do not have models. 

1640 Diablo 1640 terminal running at 1200 baud, using XON/XOFF pro- 
tocol. Options: 

-12 12-pitch (10-pitch is the default) 

— f don't use the 450{\) filter. The output has been pre- 

processed by either 450{\) or the nroffASQ driving table. 

Hewlett Packard 2631 A line printer at 2400 baud. Options: 

— c compressed print 

— e expanded print 

Printronix P300 printer using XON/XOFF protocol at 1200 baud. 

Assuming there is an existing Hewlett Packard 2631 A line printer 
named hp2, it will use the hp model interface after the command: 

/usr/lib/lpadmin — php2 — mhp 

To obtain compressed print on hp2^ use the command: 

Ip — dhp2 — — c files 

A Diablo 1640 printer called stl can be added to the LP configuration 
with the command: 

/usr/lib/lpadmin — pstl — v/dev/tty20 — ml640 

An nrojfdocument may be printed on stl in any of the following ways: 

nrofr -T450 files.) Ip -dstl -of 

files I Ip —dstl —of 
I col I Ip -dstl 

5. The following command prints the password file on stl in 12-pitch: 

Ip —dstl — ol2 /etc/ pass wd 

NOTE: the -12 option to the 1640 model should never be used in con- 
junction with nroff. 



hp 



prx 
EXAMPLE 



2. 



nroff -T450-12 
nroff — T37 files 
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FILES 

/usr/ spool/ Ip/* 

SEE ALSO 

450(1), accept(lM), enable(l), lp(l), Ipsched(lM), Ipstat(l). 
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NAME 

Ipsched, Ipshut, Ipmove — start/ stop the LP request scheduler and move 
requests 

SYNOPSIS 

/usr/lib/lpsched 
/usr/lib/lpshut 

/usr/lib/lpmove requests dest 
/usr/lib/lpmove destl dest2 

DESCRIPTION 

Lpsched schedules requests taken by lp(l) for printing on line printers. 

Lpshut shuts down the line printer scheduler. All printers that are printing 
at the time Ipshut is invoked will stop printing. Requests that were printing 
at the time a printer was shut down will be reprinted in their entirety after 
Ipsched is started again. All LP commands perform their functions even 
when Ipsched is not running. 

Lpmove moves requests that were queued by lp(l) between LP destinations. 
This command may be used only when Ipsched is not running. 

The first form of the command moves the named requests to the LP desti- 
nation, dest. Requests are request ids as returned by Ip. The second form 
moves all requests for destination destl to destination dest 2. As a side 
effect, Ip will reject requests for destl. 

Note that Ipmove never checks the acceptance status (see accept(lM)) for 
the new destination when moving requests. 



FILES 



/usr/spool/lp/* 



SEE ALSO 

accept(lM), enable(l), lp(l), Ipadmin(lM), Ipstat(l). 
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NAME 

mkfs — construct a file system 

SYNOPSIS 

/etc/mkfs special sectors [:inodes] [gap sectors/ cyl] 
/etc/mkfs special pro to [gap sectors/ cyll 

DESCRIPTION 

Mkfs constructs a 1024-byte file system by writing on the special file 
according to the directions found in the remainder of the command line. If 
the second argument is given as a string of digits, mkfs builds a file system 
with a single empty directory on it. The size of the file system is the value 
of sectors interpreted as a decimal number. This is the number of 512-byte 
sectors the file system will occupy. The boot program is left uninitialized. If 
the optional number of inodes is not given, the default is the number of 
logical blocks divided by 4. 

If the second argument is a file name that can be opened, mkfs assumes it 
to be a prototype file proto, and will take its directions from that file. The 
prototype file contains tokens separated by spaces or newlines. The first 
token is the name of a file to be copied onto block zero as the bootstrap 
program. The second token is a number specifying the size of the created 
file system in 512-byte sectors. Typically it will be the number of blocks on 
the device, perhaps diminished by space for swapping. The next token is 
the number of inodes in the file system. The maximum number of inodes 
configurable is 65500. The next set of tokens comprise the specification for 
the root file. File specifications consist of tokens giving the mode, the user 
ID, the group ID, and the initial contents of the file. The syntax of the con- 
tents field depends on the mode. 

The mode token for a file is a 6 character string. The first character 
specifies the type of the file. (The characters —bed specify regular, block 
special, character special and directory files respectively.) The second char- 
acter of the type is either u or — to specify set-user-id mode or not. The 
third is g or - for the set-group-id mode. The rest of the mode is a three 
digit octal number giving the owner, group, and other read, write, execute 
permissions (see chmodiD). 

Two decimal number tokens come after the mode; they specify the user 
and group ID's of the owner of the file. 

If the file is a regular file, the next token is a path name whence the con- 
tents and size are copied. If the file is a block or character special file, two 
decimal number tokens follow which give the major and minor device 
numbers. If the file is a directory, mkfs makes the entries . and .. and 
then reads a list of names and (recursively) file specifications for the entries 
in the directory. The scan is terminated with the token $. 

A sample prototype specification follows: 

/stand/ diskboot 
4872 110 
d--777 3 1 
usr d-- 777 3 1 

sh 755 3 1/bin/sh 

ken d-- 755 6 1 
$ 

bO b- -644 3 10 
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cO C--6443 100 

$ 
$ 

In both command syntaxes, the rotational gap and the number of sectors/cyl 
can be specified. 

The default will be used if the supplied gap and sectors/cyl are considered 
illegal values or if a short argument count occurs. 

EXAMPLE 

mkfs /dev/fdO 2000 8 50 

makes a file system on device /dev/fdO in which 2000 is number of physical 
sectors in the file system, 8 is a sector interleave number which is used to 
stagger the blocks in the free list for more rapid reading (logical blocks in 
the free list are allocated every eighth physical sector) and 50 is a modulus 
that forces mkfs to first allocate all sectors in the first cylinder, then the 
next cylinder, etc. 

NOTE: The proper selection of the gap and sectors/cyl parameters can 
improve disk efficiency. Disks which have full or partial track buffering 
should specify a m and n of 2 and 2; m and n for other disks must be deter- 
mined by trial and error as the disk latency is related to rotational latency 
and cpu speed. 

SEE ALSO 

dir(4), fs(4), boot(8). 

BUGS 

If a prototype is used, it is not possible to initialize a file larger than 64K 
bytes, nor is there a way to specify links. 

Because of the conversion from physical sectors to logical blocks necessary 
for 1024-byte file systems, blocks, gap, and blocks/cyl should all be multiples 
of 2. 
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NAME 

mkfslb — construct a file system 

SYNOPSIS 

mkfslb special size [ m n ] 
mkfslb special proto 

DESCRIPTION 

Mkfslb constructs a file system by writing, on the special file special. In the 
first form of the command a numeric size is given and mkfslb builds a file 
system with a single empty directory on it. The number of i-nodes is calcu- 
lated as a function of the filesystem size. M is an interleave factor for 
building the freelist and n is a modulo for m . See the example for usage. 

N.B.: All filesystems should have a lost+found directory for^cAidM); this 
should be created for each file system by running mklost +found (IM) in the 
root directory of a newly created file system, after the file system is first 
mounted. 

In bootstrapping, the second form of mkfslb is sometimes used. In this 
form, the file system is constructed according to the directions found in the 
prototype file proto. The prototype file contains tokens separated by spaces 
or new lines. The first token is the name of a file to be copied onto sector 
zero as the bootstrap program. The second token is a number specifying 
the size of the created file system. Typically it will be the number of blocks 
on the device, perhaps diminished by space for swapping. The next token 
is the number of i-nodes in the i-list. The next set of tokens comprise the 
specification for the root file. File specifications consist of tokens giving the 
mode, the user ID the group ID, and the initial contents of the file. The 
syntax of the contents field depends on the mode. 

The mode token for a file is a 6 character string. The first character 
specifies the type of the file. (The characters -bed specify regular, block 
special, character special and directory files, respectively.) The second char- 
acter of the type is either u or — to specify set-user-id mode or not. The 
third is g or - for the set-group-id mode. The rest of the mode is a three 
digit octal number giving the owner, group, and other read, write, execute 
permissions, see chmod{\). 

Two decimal number tokens come after the mode; they specify the user 
and group IDs of the owner of the file. 

If the file is a regular file, the next token is a pathname whence the con- 
tents and size are copied. 

If the file is a block or character special file, two decimal number tokens 
follow which give the major and minor device numbers. 

If the file is a directory, mkfslb makes the entries . and .. and then reads a 
list of names and (recursively) file specifications for the entries in the direc- 
tory. The scan is terminated with the token $. 
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A sample prototype specification follows: 

/usr/mdec/uboot 
4872 55 
d--777 3 1 
usr d- -777 3 1 

sh 755 3 1/bin/sh 

ken d- -755 6 1 
$ 

bO b--644 3 100 

cO C--644 3 100 

$ 
$ 

EXAMPLE 

mkfslb /dev/fdO 2000 7 50 

makes a file system in which 2000 is the total size of the file system to be 
put on /dev/fdO; 7 is a sector interleave number which is used to stagger 
the disk blocks for more rapid reading, every 7 blocks, and 50 is a modulo 
operator that forces the sector interlace number first to allocate all blocks in 
the first 50 sectors, then the next 50, etc. 

NOTE: The proper selection of the m and n parameters can improve disk 
efficiency. Disks which have full or partial track buffering should specify a 
m and « of 1 and 1 . M and n for other disks must be determined by trial 
and error as the disk latency is related to rotational latency and cpu speed. 

SEE ALSO 

fsck(lM), mklost+ found (IM), dir(4). 

BUGS 

The default is 3500, which is probably not useful on any disk. 
There should be some way to specify links. 
There should be some way to specify bad blocks. 
Should make lost +found automatically. 
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NAME 

mklost+found — make a lost+found directory for fsck 

SYNOPSIS 

mklost + found 

DESCRIPTION 

A directory lost + found is created in the current directory and a number of 
empty files are created therein and then removed so that there will be 
empty slots for fsckilM). This command should be run immediately after 
first mounting and changing directory to a newly created file system. For 
small file systems, it is sufficient (and much faster) to simply make a 
lost+found directory. Up to 30 files can be recovered in it. 

EXAMPLE 

mklost+found 

in the current directory, creates a directory with empty slots named 
lost + found. 

SEE ALSO 

fsck(lM), mkfs(lM) 

BUGS 

Should be done automatically by mkfs. 
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NAME 

mknod — build special file 

SYNOPSIS 

/etc/mknod name c | b major minor 
/etc/mknod name p 

DESCRIPTION 

Mknod makes a directory entry and corresponding i-node for a special file. 
The first argument is the name of the entry. In the first case, the second is 
b if the special file is block-type (disks, tape) or c if it is character-type 
(other devices). The last two arguments are numbers specifying the major 
device type and the minor device (e.g. unit, drive, or line number), which 
may be either decimal or octal. 

The assignment of major device numbers is specific to each system. They 
have to be dug out of the system source file conf.c. 

Mknod can also be used to create fifo's (a.k.a named pipes) (second case in 
SYNOPSIS ahowe). 

EXAMPLE 

mknod /dev/tty4 c 3 4 

would create file /dev/tty4 as a character special device with major number 
3 and minor number 4. 

SEE ALSO 

mknod(2). 
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NAME 

mount, umount — mount and dismount file system 

SYNOPSIS 

/etc/mount [ special directory I — r ] ] 

/etc/umount special 

DESCRIPTION 

Mount announces to the system that a removable file system is present on 
the device special. The directory must exist already; it becomes the name of 
the root of the newly mounted file system. 

These commands maintain a table of mounted devices. If invoked with no 
arguments, mount prints the table. 

The optional last argument indicates that the file is to be mounted read- 
only. Physically write-protected and magnetic tape file systems must be 
mounted in this way or errors will occur when access times are updated, 
whether or not any explicit write is attempted. 

Umount announces to the system that the removable file system previously 
mounted on device special is to be removed. 

FILES 

/etc/mnttab mount table 

EXAMPLE 

mount /dev/xxxx /t 

mounts device /dev/xxxx as file system /t. 

SEE ALSO 

setmnt(lM), mount(2), mnttab(4). 

DIAGNOSTICS 

Mount issues a warning if the file system to be mounted is currently 
mounted under another name. 

Umount complains if the special file is not mounted or if it is busy. The file 
system is busy if it contains an open file or some user's working directory. 

BUGS 

Some degree of validation is done on the file system, however it is gen- 
erally unwise to mount garbage file systems. 
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NAME 

mvdir — move a directory 

SYNOPSIS 

/etc/mvdir dirname name 

DESCRIPTION 

Mvdir renames directories within a file system. Dirname must be a direc- 
tory; name must not exist. Neither name may be a sub-set of the other 
(/x/y cannot be moved to /x/y/z, nor vice versa). 

Only super-user can use mvdir. 

EXAMPLE 

mvdir dirl dir2 

renames existing directory "dirl" to be a new directory "dir2". 

SEE ALSO 

mkdir(l). 
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NAME 

ncheck — generate names from i-numbers 

SYNOPSIS 

/etc/ncheck [ — i numbers ] [ — a ] [ — s 1 [ file-system ] 

DESCRIPTION 

N.B.: For most normal file system maintenance, the function of ncheck is 
subsumed by fsck (IM). 

Ncheck with no argument generates a path name vs. i-number list of all 
files on a set of default file systems. Names of directory files are followed 
by /.. The — i option reduces the report to only those files whose i- 
numbers follow. The —a option allows printing of the names . and .., 
which are ordinarily suppressed. The — s option reduces the report to spe- 
cial files and files with set-user-ID mode; it is intended to discover con- 
cealed violations of security policy. 

A file system may be specified. 

The report is in no useful order, and probably should be sorted. 

EXAMPLE 

ncheck /dev/rdiskl 

will report the pathnames and i-numbers of files on the specified device. 

SEE ALSO 

fsck(lM), sort(l). 

DIAGNOSTICS 

When the file system structure is improper, ?? denotes the "parent" of a 
parentless file and a path name beginning with ... denotes a loop. 
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NAME 

prfld, prfstat, prfdc, prfsnap, prfpr — operating system profiler 

SYNOPSIS 

/etc/prfld [ namelist ] 

/etc/prfstat [ on | off ] 

/etc/prfdc file [ period [ off hour ] ] 

/etc/prfsnap file 

/etc/prfpr file [ cutoff [ namelist ] ] 

DESCRIPTION 

. Prfld', prfstat, prfdc, prfsnap, and prfpr form a system of programs to facili- 
tate an activity study of the UNIX operating system. 

Prfld is used to initialize the recording mechanism in the system. It gen- 
erates a table containing the starting address of each system subroutine as 
extracted from namelist. 

Prfstat is used to enable or disable the sampling mechanism. Profiler over- 
head is less than 1% as calculated for 500 text addresses. Prfstat will also 
reveal the number of text addresses being measured. 

Prfdc and prfsnap perform the data collection function of the profiler by 
copying the current value of all the text address counters to a file where the 
data can be analyzed. Prfdc will store the counters into file every period 
minutes and will turn off at off'hour (valid values for offjiour zx^ 0-24). 
Prfsnap collects data at the time of invocation only, appending the counter 
values to file. 

Prfpr formats the data collected by prfdc or prfsnap. Each text address is 
converted to the nearest text symbol (as found in namelist) and is printed if 
the percent activity for that range is greater than cutofl'. 



FILES 



/dev/prf interface to profile data and text addresses 
/unix default for namelist file 
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NAME 

pstat — print system facts 

SYNOPSIS 

pstat [ — aixptuf ] [ suboptions ] [ file ] 

DESCRIPTION 

Pstat interprets the contents of certain system tables. If file is given, the 
tables are sought there, otherwise in /dev/mem. The required namelist is 
taken from /unix. Options are: 

-a Under — p, describe all process slots rather than just active ones. 



Print the inode table with these headings: 



LOC 

FLAGS 
L 
U 
A 
M 
W 
T 
C 

CNT 

DEV 

INO 

MODE 

NLK 

UID 

SIZ/DEV 



The core location of this table entry. 
Miscellaneous state variables encoded thus: 

locked 

update time ^5(5) must be corrected 

access time must be corrected 

file system is mounted here 

wanted by another process (L flag is on) 

contains a text file 

changed time must be corrected 
Number of open file table entries for this inode. 
Major and minor device number of file system in which this 
inode resides. 

I-number within the device. 
Mode bits, see chmodil). 
Number of links to this inode. 
User ID of owner. 

Number of bytes in an ordinary file, or major and minor 
device of special file. 

-X Print the text table with these headings: 

LOC The core location of this table entry. 

FLAGS Miscellaneous state variables encoded thus: 

T ptraceil) in effect 

W text not yet written on swap device 

L loading in progress 

K locked 

w wanted (L flag is on) 
DADDR Disk address in swap, measured in multiples of 512 bytes. 
CADDR Core address, measured in multiples of core clicks (machine 

dependent). 
SIZE Size of text segment, measured in muUiples of core clicks 

(machine dependent). 
IPTR Core location of corresponding inode. 
CNT Number of processes using this text segment. 

CCNT Number of processes in core using this text segment. 

-p Print process table for active processes with these headings: 
LOC The core location of this table entry. 

S Run state encoded thus: 

no process 

1 waiting for some event 
3 runnable 
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4 being created 

5 being terminated 

6 stopped under trace 

F Miscellaneous state variables, or-ed together: 

01 loaded 

02 the scheduler process 

04 locked 

010 swapped out 

020 traced 

040 used in tracing 

0100 

locked in by lock(2). 
PRI Scheduling priority, see nicei2). 

SIGNAL Signals received (signals 1-16 coded in bits 0-15), 
UID Real user ID. 

TIM Time resident in seconds; times over 127 coded as 127. 

CPU Weighted integral of CPU time, for scheduler. 

NI Nice level, see niceiX). 

PGRP Process number of root of process group (the opener of the 

controlling terminal). 
PID The process ID number. 

PPID The process ID of parent process. 

ADDR If in core, the physical address of the "u-area" of the process 
measured in multiples of 64 bytes. If swapped out, the posi- 
tion in the swap area measured in multiples of 512 bytes. 
SIZE Size of process image in multiples of 64 bytes. 
WCHAN Wait channel number of a waiting process. 
LINK Link pointer in list of runnable processes. 
TEXTP If text is pure, pointer to location of text table entry. 
CLKT Countdown for alarm(2) measured in seconds. 

Print table for terminals (only DHll and DLll handled) with these 

headings: 

RAW Number of characters in raw input queue. 

CAN Number of characters in canonicalized input queue. 

OUT Number of characters in output queue. 

MODE See tty(4). 

ADDR Physical device address. 

DEL Number of delimiters (newlines) in canonicalized input 

queue. 
COL Calculated column position of terminal. 

STATE Miscellaneous state variables encoded thus: 

W waiting for open to complete 

O open 

5 has special (output) start routine 
C carrier is on 

B busy doing output 

A process is awaiting output 

X open for exclusive use 

H hangup on close 

PGRP Process group for which this is controlling terminal. 

print information about a user process; the next argument is its 
address as given by ps(l). The process must be in main memory, or 
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the file used can be a core image and the address 0. 

Print the open file table with these headings: 

LOC The core location of this table entry. 

FLG Miscellaneous state variables encoded thus: 

R open for reading 

W open for writing 

P pipe 

CNT Number of processes that know this open file. 

INO The location of the inode table entry for this file. 

OFFS The file offset, see IseekO). 



FILES 



/unix namelist 

/dev/mem default source of tables 



EXAMPLE 

pstat -i 

displays all the active inodes in a table format with headings. 

SEE ALSO 

ps(l), stat(2), fs(5) 

UNIX Implementation, by K. Thompson. 
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NAME 

pwck, grpck — password/group file checkers 

SYNOPSIS 

/etc/pwck [file] 
/etc/grpck [file] 

DESCRIPTION 

Pwck scans the password file and notes any inconsistencies. The checks 
include validation of the number of fields, login name, user ID, group ID, 
and whether the login directory and optional program name exist. The cri- 
teria for determining a valid login name is derived from "Setting up the 
UNIX System" in the UniPlus'^ Administrator's Guide. The default password 
file is /etc/passwd. 

Grpck verifies all entries in the group file. This verification includes a check 
of the number of fields, group name, group ID, and whether all login 
names appear in the password file. The default group file is /etc/group. 

EXAMPLE 

pwck 

will list inconsistencies in /etc/passwd. 

grpck 
will list inconsistencies in /etc/group. 

FILES 

/etc/group 
/etc/passwd 

SEE ALSO 

group (4), passwd(4). 

"Setting up the UNIX System" in UniPlus^ Administrator's Guide. 

DIAGNOSTICS 

Group entries in /etc/group with no login names are flagged. 
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NAME 

runacct — run daily accounting 

SYNOPSIS 

/usr/iib/acct/runacct [mmdd [state]] 

DESCRIPTION 

Runacct is the main daily accounting shell procedure. It is normally ini- 
tiated via crowd M). Runacct processes connect, fee, disk, and process 
accounting files. It also prepares summary files for prdaily or billing pur- 
poses. 

Runacct takes care not to damage active accounting files or summary files 
in the event of errors. It records its progress by writing descriptive diagnos- 
tic messages into active. When an error is detected, a message is written to 
/dev/console, mail (see mailiX)) is sent to root and adm, and runacct ter- 
minates. Runacct uses a series of lock files to protect against re-invocation. 
The files lock and lockl are used to prevent simultaneous invocation, and 
lastdate is used to prevent more than one invocation per day. 

Runacct breaks its processing into separate, restartable states using statefile 
to remember the last state completed. It accomplishes this by writing the 
state name into statefile. Runacct then looks in statefile to see what it has 
done and to determine what to process next. States are executed in the fol- 
lowing order: 

SETUP Move active accounting files into working files. 

WTMPFIX Verify integrity of wtmp file, correcting date changes 

if necessary. 

CONNECTl Produce connect session records in ctmp.h format. 

CONNECT2 Convert ctmp.h records into tacct.h format. 

PROCESS Convert process accounting records into tacct.h for- 

mat. 

MERGE Merge the connect and process accounting records. 

FEES Convert output of chargefee into tacct.h format and 

merge with connect and process accounting records. 

DISK Merge disk accounting records with connect, process, 

and fee accounting records. 

MERGETACCT Merge the daily total accounting records in daytacct 
with the summary total accounting records in 
/usr/adm/acct/sum/tacct. 

CMS Produce command summaries. 

USEREXIT Any installation-dependent accounting programs can 
be included here. 

CLEANUP Cleanup temporary files and exit. 

To restart runacct after a failure, first check the active file for diagnostics, 
then fix up any corrupted data files such as pacct or wtmp. The lock files 
and lastdate file must be removed before runacct can be restarted. The 
argument mmdd is necessary if runacct is being restarted, and specifies the 
month and day for which runacct will rerun the accounting. Entry point for 
processing is based on the contents of statefile; to override this, include the 
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desired state on the command line to designate where processing should 
begin. 

EXAMPLE 

nohup runacct 2> /usr/adm/acct/nite/fd21og & 

starts runacct. 

nohup runacct 0601 2> > /usr/adm/acct/nite/fd21og & 
restarts runacct. 

nohup runacct 0601 MERGE 2>> /usr/adm/acct/nite/fd21og & 
restarts runacct at a specific state. 

FILES 

/etc/wtmp 

/usr/adm/pacct* 

/usr/src/cmd/acct/tacct.h 

/usr/src/cmd/acct/ctmp.h 

/ usr/ adm/ acct/ nite/ active 

/ usr/ adm/ acct/ ni te/ day tacct 

/usr/ adm/ acct/ nite/ lock 

/usr/ adm/acct/ nite/ lock 1 

/ usr/ adm/ acct/ nite/ lastdate 

/usr/adm/acct/nite/statefile 

/ usr/ adm/ acct/ nite/ ptacct* . mmdd 

SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), 

acctprc(lM), acctsh(lM), cron(lM), fwtmp(lM), acct(2), acct(4), 

utmp(4). 

"UNIX Accounting System" in the UniPlus'^ Administrator's Guide. 

DIAGNOSTICS 

The accounting system will start complaining with ***RECOMPILE pnpsplit 
WITH NEW HOLIDAYS*** after the last holiday of the year. See "The 
UNIX Accounting System" for more on how to correct this condition. 
Other diagnostics are placed in various error and log files. 



BUGS 



Normally it is not a good idea to restart runacct in the SETUP state. Run 
SETUP manually and restart via: 

runacct mmdd WTMPFIX 

If runacct failed in the PROCESS state, remove the last ptacct file because it 
will not be complete. 
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NAME 

sal, sa2, sadc — system activity report package 

SYNOPSIS 

/usr/lib/sa/sadc [t n] lofile] 

/usr/lib/sa/sal [t n] 

/usr/lib/sa/sa2 [-ubdycwaqvm] [— s time! [— e time] [— i sec] 

DESCRIPTION 

System activity data can be accessed at the special request of a user (see 
sard)) and automatically on a routine basis as described here. The 
operating system contains a number of counters that are incremented as 
various system actions occur. These include CPU utilization counters, 
buflTer usage counters, disk and tape I/O activity counters, TTY device 
activity counters, switching and system-call counters, file-access counters, 
queue activity counters, and counters for inter-process communications. 

Sadc and shell procedures sal and sa2 are used to sample, save and process 
this data. 

Sadc, the data collector, samples system data n times every t seconds and 
writes in binary format to ofile or to standard output. If t and n are 
omitted, a special record is written. This facility is used at system boot 
time to mark the time at which the counters restart from zero. The /etc/rc 
entry: 

su adm — c "/usr/lib/sa/sadc /usr/adm/sa/sa''date -l-%d''&" 
writes the special record to the daily data file to mark the system restart. 

The shell script sal, a variant of sadc, is used to collect and store data in 
binary file /usr/adm/sa/sa£f</ where ddis the current day. The arguments t 
and n cause records to be written n times at an interval of t seconds, or 
once if omitted. The entries in crontab (see cronilM)): 

* * * 0,6 su adm — c "/usr/lib/sa/sal" 

8-17 * * 1-5 su adm -c "/usr/lib/sa/sal 1200 3" 

18—7 * * 1 — 5 su adm — c "/usr/lib/sa/sal" 
will produce records every 20 minutes during working hours and hourly 
otherwise. 

The shell script sa2, a variant of saril), writes a daily report in file 
/usr/adm/sa/sarfiW. The options are explained in saril). The crontab 
entry: 

5 18 ♦ * 1-5 su adm -c "/usr/lib/sa/sa2 -s 8:00 -e 18:01 -i 3600 -A" 

will report important activities hourly during the working day. 
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The structure of the binary daily data file is: 

struct sa { 

struct sysinfo si; 

int szinode; 

int szfile; 

int sztext; 

int szproc; 

int mszinode; 

int mszfile; 

int msztext; 

int mszproc; 

long inodeovf; 

long inodeovf; 

long textovf; 

long procovf; 

time_t ts; 

long devio[NDEVS][4l; 
#define IO_OPS 

#define IO_BCNT 1 

#define IO_ACT 2 

#define 10 RESP 3 



* see /usr/include/sys/sysinfo.h */ 

* current entries of inode table */ 

* current entries of file table */ 

* current entries of text table */ 

* current entries of proc table ♦/ 

* size of inode table ♦/ 

* size of file table */ 

* size of text table */ 

* size of proc table */ 

* cumul. overflows of inode table */ 

* cumul. overflows of file table */ 

* cumul. overflows of text table •/ 

* cumul. overflows of proc table */ 

* time stamp, seconds */ 

* device info for up to NDEVS units */ 

* cumul. I/O requests */ 

* cumul. blocks transferred ♦/ 

* cumul. drive busy time in ticks */ 

* cumul. I/O resp time in ticks ♦/ 



FILES 



/usr/adm/sa/sac/c/ 

/usr/adm/sa/sarrfrf 

/tmp/sa.adrfl 



daily data file 
daily report file 
address file 



SEE ALSO 

sag(lG), sar(l), timex(l). 
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NAME 

setmnt — establish mount table 

SYNOPSIS 

/etc/setmnt 

DESCRIPTION 

Setmnt creates the /etc/mnttab table (see mnttab{4)), which is needed for 
both the mountilM) and umount commands. Ser/w/j/ reads standard input 
and creates a mnttab entry for each line. Input lines have the format: 

filesys node 

where filesys is the name of the file system's special file (e.g., "rp??") and 
node is the root name of that file system. Thus filesys and node become the 
first two strings in the mnttab{4) entry. 

EXAMPLE 

/etc/devnm / | grep -vv swap | grep -v root | /etc/settmnt 

will put an entry for the root file system and the device on which it is 
mounted into the file /etc/mnttab (except if it is mounted on a device 
named "swap" or "root"). 

FILES 

/etc/mnttab 

SEE ALSO 

mnttab (4). 

BUGS 

Evil things will happen if filesys or node are longer than 10 characters. 
Setmnt silently enforces an upper limit on the maximum number of mnttab 
entries. 
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NAME 

shutdown — terminate all processing 

SYNOPSIS 

/etc/shutdown 

DESCRIPTION 

Shutdown is part of the UNIX System operation procedures. Its primary 
function is to terminate all currently running processes in an orderly and 
cautious manner. The procedure is designed to interact with the operator 
(i.e., the person who invoked shutdown). Shutdown may instruct the opera- 
tor to perform some specific tasks, or to supply certain responses before 
execution can resume. Shutdown goes through the following steps: 

All users logged on the system are notified to log off the system by a 
broadcasted message. The operator may display his/her own message at 
this time. Otherwise, the standard file save message is displayed. 

If the operator wishes to run the file-save procedure, shutdown 
unmounts all file systems. 

All file systems' super blocks are updated before the system is to be 
stopped (see syndD). This must be done before re-booting the system, 
to insure file system integrity. The most common error diagnostic that 
will occur is device busy. This diagnostic happens when a particular file 
system could not be unmounted. 

SEE ALSO 

mount(lM), sync(l). 
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NAME 

updater — update files between two machines 

SYNOPSIS 

updater [ key ] local remote ... 

DESCRIPTION 

Updater updates files between two machines. 

One of the following key letters must be included: 

t Take files from the remote machine, updating the local machine. 

p Put files from the local machine onto the remote machine, updating the 
remote machine. 

d List the difference between files on the local and remote machines. 

The following key letters are optional: 

u Update a file only if it exists on both machines; this is the default condi- 
tion. 

r Replace a file if it did not exist on the destination machine. 

Local refers to the local directory name. 

Remote refers to the remote directory names. Only one remote name can 
be specified if the p (put) key is specified. 

ALGORITHM 

Open /dev/ttyO to the remote machine. 

Stty the local port and send a stty command to the remote machine to con- 
dition both ends of the connection. 

Send a "cd remote ; sumdir . | sort -1-2 > /tmp/rXXXXX" to remote 
machine for each remote system; "cd local ; sumdir . | sort > 
/tmp/lXXXXX" for local machine. 

Wait for remote to complete. 

Take /tmp/rXXXXX. 

Do a comparison between the local and the union of the remotes: 
exists on remote only: 

If both the t and r keys are specified, take the file; 

otherwise list the file, 
exists on local only: 

If both p and r keys are specified, put the file; 

otherwise list the file, 
exist on both but different: 

If t key is specified, take the file. 

If p key is specified, put the file. 

If d key is specified, list the file, 
same: 

nothing 

EXAMPLE 

updater d . . 

uses /dev/ttyO to communicate with a remote machine, and compares 
directories on the remote and local systems. 
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NAME 

uuclean — uucp spool directory clean-up 

SYNOPSIS 

/usr/lib/uucp/uuclean [ options ] 

DESCRIPTION 

Uuclean will scan the spool directory for files with the specified prefix and 
delete all those which are older than the specified number of hours. 

The following options are available. 

— ^directory Clean directory instead of the spool directory. 

— ppre Scan for files with pre as the file prefix. Up to 10 — p argu- 

ments may be specified. A — p without any pre following will 
cause all files older than the specified time to be deleted. 

— ntime Files whose age is more than time hours will be deleted if the 

prefix test is satisfied, (default time is 72 hours) 

— y/file The default action for uuclean is to remove files which are 

older than a specified time (see — n option). The — w option 
is used to find those files older than time hours, however, the 
files are not deleted. If the argument file is present the warn- 
ing is placed in file, otherwise, the warnings will go to the 
standard output. 

— ssys Only files destined for system sys are examined. Up to 10 — s 

arguments may be specified. 

— mflle The — m option sends mail to the owner of the file when it is 

deleted. If a file is specified then an entry is placed in file. 

This program is typically started by crow (IM). 

EXAMPLE 

uuclean -pT -pRC -nO -m 

removes all files in /usr/spool/uucp with a prefix of T or RC, and mails 
notifications to the owners of the removed files. 



FILES 



/usr/ lib/ uucp directory with commands used by uuclean internally 
/usr/spool/uucp spool directory 



SEE ALSO 

cron(lM), uucp(lC), uux(lC). 
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NAME 

uusub — monitor uucp network 

SYNOPSIS 

/usr/lib/uucp/uusub [ options ] 

DESCRIPTION 

Uusub defines a uucp subnetwork and monitors the connection and traffic 
among the members of the subnetwork. The following options are avail- 
able: 

— Asys Add sys to the subnetwork. 

— dsy5 Delete sys from the subnetwork. 

— 1 Report the statistics on connections. 

— r Report the statistics on traffic amount. 
-f Flush the connection statistics. 

— vkhr Gather the traffic statistics over the past hr hours. 

— csys Exercise the connection to the system sys. If sys is specified as 

all, then exercise the connection to all the systems in the subnet- 
work. 

The meanings of the connections report are: 

sys #call #ok time #dev #login #nack #other 

where sys is the remote system name, #call is the number of times the 
local system tries to call sys since the last flush was done, #ok is the 
number of successful connections, time is the latest successful connect 
time, #<fev is the number of unsuccessful connections because of no avail- 
able device (e.g. ACU), # login is the number of unsuccessful connections 
because of login failure, #nack is the number of unsuccessful connections 
because of no response (e.g. line busy, system down), and # other is the 
number of unsuccessful connections because of other reasons. 

The meanings of the traffic statistics are: 

sfile sbyte rfile rbyte 

where sfile is the number of files sent and sbyte is the number of bytes sent 
over the period of time indicated in the latest uusub command with the 

— vihr option. Similarly, rfile and rbyte are the numbers of files and bytes 
received. 

EXAMPLE 

uusub — c all — u 24 



FILES 



is typically started by crow (IM) once a day. 

/usr/ spool/ uucp/ SYSLOG system log file 
/usr/lib/uucp/Lsub connection statistics 

/usr/lib/uucp/R_sub traffic statistics 

SEE ALSO 

uucp(lC), uustat(lC). 



October 1983 - 1 



VCHK(IM) (UniSoft) VCHK(IM) 



NAME 

vchk — version checkup 

SYNOPSIS 

Tchk [ argument ] ... 

DESCRIPTION 

Vchk is a highly specialized form of makeil) designed to check and main- 
tain the modes, ownerships, and versions of a set of files specified in the 
description file. The description file is essentially a "photograph" of what a 
healthy system (i.e., one with all its components in the correct state) looks 
like. It contains a list of pathnames (for both files and directories) that 
should exist and have specific protections and contents. Vchk reads the 
description file, checks each item specified and prints error messages when 
a file does not match its description. Many problems can be fixed directly 
by vchk^ such as incorrect mode and/ or owner and missing link names. All 
other problems involve actually replacing a file, detected by comparing 
some combination of checksum, length, and/ or version number (from the 
description file) with the value generated from the actual file being checked. 
When a file needs to be replaced vchk invokes the command named by the 
REMAKE macro (see MACROS below). 

Each argument is either a definition or an option. Option arguments begin 
with the character — and consist of a string of letters (called flags) from 
the set API PSa bcdeflklmprstyx. The f and t flags cause the next argument 
to be considered specially. The p and P flags cause the rest of the argu- 
ment in which they appear to be considered specially. Other arguments are 
either macro definitions (i.e., name — string pairs) or simply strings which 
are saved as numeric macros. Briefly, the flags are as follows: 

— Asysid 

specifies an alternate sysid rather than using the one found in 
/etc/sys_id. 

— D enables debugging messages. 
-I process control lines only. 

— V sysid 

preprocess the description file; sysid is optional and is explained below 
under PREPROCESSING. 

— S suppress printing of non-fatal error messages. 

— a checks all lines in the description file. Modifies the b, P, and k op- 

tions. 

— b build a description file for the current directory. 

-c print shell commands to fix the file system. 

— d suppress re-installation commands and error messages. 

— e suppress checks for everything but existence. 

—{filename 

cause vchk to read filename instead of /etc/vchk_tree. 

— i go interactive: modifies b, c, and x options. 

— k perform checksums on files having checksum field. 
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— 1 suppress listing of files left in directories. 

— m allow multiple copies of files. 

-Jtpwjile 

force vchk to re-evaluate and/or use an alternate password file. 

-r allow redundant password entries (user IDl). 

— s remain silent about trivial problems. 

— V suppress checking of version numbers. 

-X execute shell commands to fix the file system (cf. the — c option 
which prints rather than executes) . 

DESCRIPTION FILE SYNTAX 

Lines in the description file are either comments, control lines, 
specifications, or commands. Control lines provide a simple (^e/ mechan- 
ism for selectively ignoring specification lines. Specification lines describe 
files and/or directories that need to be checked. Commands are not pro- 
cessed by vchk but (in the spirit of makeil)) are used when the file 
specified above them is found to need replacing. 

Several conventions are observed to maintain the readability of the descrip- 
tion file; for example, a trailing backslash and all leading white space on the 
following line are ignored when processed. In addition, backslash may be 
used to delay the expansion of macros (in macro definitions only) and, as 
described below, to alter the evaluation of parentheses and braces in path- 
names. 

COMMENTS 

Comment lines always st^rt with a '#'. If the second character on a com- 
ment line is also a '#', then that line is printed on the standard error when 
read by vchk. Any line may have a trailing comment, which is universally 
ignored. 

CONTROL LINES 

Control lines start with a \' (period). The mechanism is similar to the C 
language pre-processor except that defined words do not have values associ- 
ated with them; words are simply defined or not. The control commands 
supported are as follows: 

.define wordlist 

where wordlist is a list of white-space-separated words to be defined 
which have no associated values. Note that only the first twelve 
letters of defined words are significant. Storage for defined words is 
static. There is a maximum of sixty defined words at any given time. 

. ifdef define_expression 

where defineexpression is an infix boolean expression involving 
defined words and the operators !, &, and |, which mean 'not', 'and', 
and 'or', respectively. The value of each word evaluates to a boolean 
"yes" if that word is defined and "no" if not. If the expression evalu- 
ates to be false, lines are ignored until the matching .endif or .else 
control line is read. Ifndef is also supported and reverses the sense of 
the expression test. 

.include filename 

is very similar the C pre-processor include with the exception that 
there are no default searching places and that the filename is not en- 
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closed in double quotes or angle brackets. In addition, if the first 
character of the filename is an exclamation mark (!), then the rest of 
line is considered to be a shell command and its standard output is 
what gets included. 

.u/i(/i^wordlist 

undefines each word in the wordlist. 

.t//25f/ wordlist 

frees the storage associated with macro definitions (detailed in a fol- 
lowing section) for the given wordlist (which is composed of macro 
names). Words in wordlist that are already unset (or were never set) 
are silently ignored. 

xhdir directory_name 

changes the current directory to the one specified and alters the start- 
ing location of pathnames anchored from the current directory. 

.exit message 

causes vchk to print the message and exit immediately. 

As an aid to debugging the description file, a single \' on a line by itself 
causes vchk to print the currently defined control symbols on the standard 
error when it reads that line. 

MACROS 

A macro processing facility very similar to the one used by makeil) is pro- 
vided. Macros are defined when a line containing the macro name, an 
equal sign, and the value is read. The value may be null or include macro 
invocations. Unlike defined' words, macro names are fully significant and 
are saved in dynamic memory. Macros are invoked by the '$' character. 
As in make scripts, macro names must be surrounded by Os when they are 
longer than a single letter. There is a special macro (named '.', thus refer- 
enced with '$.') which always expands to the name of the current directory. 
It is useful in the construction of link names since most files have their 
links close by. 

Except in the definition of a new macro (where interpretation may need to 
be delayed) and in comments, it is always an error for a macro to be used if 
it is undefined. Since the '##' comment is printed after macro substitution, 
it is a useful debugging tool. In keeping with the spirit of the Mump control 
words' command (.), a single '$' on a line by itself prints all the currently 
defined macros and their values. 

Note that lines are re-scanned once a macro has been substituted so that a 
macro may be defined to expand to a control line, comment, or even a 
macro definition. Note that this degenerates to a recursive loop if the 
definition of a macro contains a reference to that macro. 

Two predefined macros exist. The first, called REMAKE, contains the name 
(and options) of the program to use to replace damaged or missing files. If 
the file /etc/sys_id exists and is not empty, it is assumed to contain the 
UniSoft code name assigned to your system and vchk will setup the 
REMAKE macro to be the command "take — iN" where N is the name 
found in /etc/sys_id. This allows systems that reside at UniSoft to be up- 
dated automatically over a direct tty line via the takeilM) program. If the 
/etc/sys_id file has a single empty line in it, then REMAKE will be set to 
"take — i". This allows remote systems to be updated automatically over 
phone lines. If the /etc/sys_id file does not exist, vchk sets the REMAKE 
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macro to be "install". Note that the description file may redefine the 
REMAKE macro at any time. 

The second predefined macro is called ARGS and can be set but not refer- 
enced. Strings assigned to ARGS are treated as command line options. The 
— preceding option keyletters is still required, and enables that option. A 
plus sign, '+', must be used instead to disable a keyletter option. Resetting 
the b, p, and r is not allowed. 

DESCRIPTION LINES 

Each line that is not a comment, control line, macro definition, or com- 
mand is considered to be the specification for a particular file or directory. 
These have a simple and regular syntax: the first and only mandatory field 
is the pathname^ which must begin at the root (/) or the current directory 
(./). In practice we find that starting all lines with a macro allows easy relo- 
cation of the entire tree described and is very readable. 

The rest of the line contains optional information about the contents and 
protection of the file. Contents specifications are separated from the path- 
name by white space. The entire protection specification is bracketed to 
separate it from the rest of the line. 

PATHNAMES 

Pathnames refer to directories (if and only if they end in a 7' character) or 
files (if they do not end in a 7'). Use of shell metacharacters (globbing) is 
not supported but two mechanisms are provided to allow variable path- 
names: braces, {}s, and parentheses. Braces are interpreted just as in 
cshd); each of the expanded pathnames must exist and must match the 
description given. Parentheses in pathnames are interpreted similarly, ex- 
cept that exactly one of the resulting pathnames must exist. This feature is 
useful, for example, to allow a program to be in either /bin or /usr/bin, 
but not both. 

Parentheses and braces are expanded left to right; for example, the con- 
struction (a,b){x,y} means either ax and ay must exist or bx and by. 
Backslashes may be used to delay or prevent the interpretation of Os and 
{}s. For example, \(a,b\){x,y} means one of ax or bx and one of ay or by 
must exist. One layer of backslashes are removed for each pass through 
the pathname and each time an unescaped parenthesis or bracket is detect- 
ed and expanded, another pass is made. 

Note that when alternative paths are used (i.e., parentheses occur in the 
pathname) the first one is considered the one to be rebuilt in the event that 
all are missing. For example, the pathname (/usr) /bin/Is would look first 
in /usr/bin for Ms', then in /bin, and try to "REMAKE /usr/bin/ls" if both 
are missing. The reverse is true for (,/usr)/bin/ls. 

SPECIFICATIONS 

Two kinds of specifications are implemented. The first kind deals with the 
contents of the file or directory and follows the pathname (separated from 
it by white space). The second kind deals with the files protection; these are 
enclosed in some type of parentheses to separate them from contents 
specifications. The kind of parentheses used, ()s, lis, <>s, or {)s, modify 
the action taken by vchk according to the table below: 

Enables checking and replacing of the file. 

[] Enables checking but never replacing. If the file is missing, vchk 

will complain but not try to rebuild it. 
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<> Enables checking (if and only if the file exists or the -a command 
line option is given) and never replacing. 

{} Enables checking but not repairing, (i.e., if the file is missing then 

it will be remade, but if it exists and is incorrect it will not be 
remade). 

Associated with each directory is a default mode and ownership for the files 
and directories contained within it. Unless explicitly given, each directory 
inherits its defaults from its parent directory. If unspecified, the uppermost 
directory (either the root or current directory) sets the mode and ownership 
of its contents from its own mode and ownership. These defaults may be 
reset at any time simply by following the directory name with a mode 
and/or user name. 

Regular files have three optional contents specification fields: length, check- 
sum, and version number. These may be specified with a word (either 
Length, Checksum, or Version), an optional space, or a numeric value. 
The word may be any prefix, for example, 'Length 34' or 'L34'. The 
checksums used are the same as those produced by sumil). The length 
checked is that returned by stat{2). These checks do not apply to device 
files (only block and character devices are supported); thus their contents 
specification field must begin with either b or c and must be followed by the 
major and minor device number (separated by white space) . If x is used in- 
stead of either the major or minor device number, vchk will allow the dev- 
ice to have any value. 

The protection specification consists of a list of command prefixes separated 
by semicolons. The commands supported are chmod, chown, and link to. If 
angle brackets (i.e., <>s) are used instead of parentheses to enclose the 
protection specification, the file or directory so referenced is optional and 
will not generate diagnostics if it is missing. It can be raised to the status of 
lis by giving the -a command line option. If square brackets (i.e., lis) are 
used, the referenced file cannot be replaced automatically, as for example, 
the password file. If curly brackets (i.e., {}s) are used, the referenced file 
will be replaced only if it is missing, not if it exists and is wrong (according 
to the description file). This is useful for files like /etc/termcap. 

Any other information in the protection specification is treated as a special 
comment that is printed with error messages about that file. 

OPERATION 

In order for vchk to check the ownership of files it must map user ID 
numbers onto login names. The password file is normally used for this 
mapping but it is too expensive to look up each name every time it is used 
so vchk creates a temporary file (/etc/vchk_pw) the first time it is run; 
whenever its temporary is out of date with respect to the real password file, 
vchk recreates the temporary file. 

In the process of reading the password file vchk inspects each account and 
prints diagnostics when it finds questionable data there. These messages 
are warnings or simply situations which bear reporting; the format of these 
messages is "Line <number>: message". The word "Error: " is prepended 
to the warnings for a particular line if vchk has decided to ignore that line 
of the password file. 

The —pipwfile] option is provided to allow users who do not have write 
permission in /etc to use vchk. If specified with a filename after it, vchk 
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will get the saved password information from that file. If the file does not 
exist, vchk will create it. Use of the — p option without a filename informs 
vchk to reprocess the password file even if it is not out of date. 

Vchk normally expects the description file to be /etc/vchk_tree, but if the 
standard input to vchk is a regular file, that file will be read instead. 

Instead of redirecting the standard input, the — f option can be used to 
respecify the description file. It is an error to use both. 

The best way to build a new description file is to chdir to the appropriate 
directory and run vchk with the -b option. A description file for the 
current directory will be produced on the standard output. The -i option 
may also be used, causing vchk to ask before descending each directory. 

In addition to reporting errors, the — c flag prints shell commands to correct 
the detected error. The — i option can be used with the — c option to ask 
before outputting a command. 

It is inadvisable to use the — x flag until the description file has been used 
and debugged. This flag allows vchk to execute the chmod(2), chownil), 
and /«(2) commands internally, saving much time. Re-installation com- 
mands (cf. the REMAKE macro) are executed via the system(3) call. 

PREPROCESSING 

The -PsysW command line option provides a means for simplifying a com- 
plex description file. Everything except macro substitution is suppressed 
and after each line is parsed, it is printed on the standard output instead of 
being used to check the filesystem. 

If a sysid is given after the — P flag, then it is used to lookup a line from 
the (/etc/takelist) file. (See takeilm) for a more complete description of 
the function of the /etc/takelist file.) 

The lines in /etc/takelist are composed of any number of fields (called al- 
ternates) separated by colons (:s). The first alternate in a line is a list of 
system names separated by or bars (Is). The s^s/rf above is compared with 
each of the system names in the first alternate of each line until it is found. 
If not found, then vchk exits with an appropriate error message. 

When the line from /etc/takelist for the current sysid is found, then each 
of the additional alternates are considered lists of root directories (separated 
by colons or bars) to be prepended to filenames in the tree file before look- 
ing for them. 

If a file is found in more or less than exactly 1 place in the list, then an er- 
ror is reported and that line is not include in the preprocessed output. If it 
is found, then the checksum, length, and version number are computed 
from that file and replaced in the preprocessed output. 

EXAMPLE 

Following are some excerpts from a typical description file. 

B = (/usr)/bin # programs can be in /bin or /usr/bin 

/ bin 755 (chmod 755) 

$B/ar Version 1.0 

$B/awk Version 1.3 

$B/more Version 1.0 (link to $./page) 

$B/sccsdiff C54686L1253 (sheU script) 

$B/su Version 1 .0 (chown root; chmod 4755) 
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FILES 



/etc/ root 644 

/etc/passwd 

/etc/ group 

/etc/init Version 1.0 

/etc/update Version 1.1 

/etc/ddate 



[password file] 
[group file] 
(chmod 700) 
(chmod 700) 
<dump dates > 



The first line of the above example defines a macro, B, to be the string 
(/usr)/bin. This macro is then invoked on lines 3 through 7 of the exam- 
ple to allow the programs mentioned to be in either /usr/bin or /bin. 

The second line specifies that the root directory (/)shouldhaveinode that 
the default mode and owner for files found in it be 755 and bin. 

The third line specifies that the ar program should be version 1.0, owned 
by bin and have mode 755. The mode and owner are implied in the fol- 
lowing way. Each directory inherits its mode and ownership from its 
parent. Thus /bin inherits the owner of root (which is unspecified in the 
example and thus defaults to whatever the owner of the root (/) is when 
the example is run). The mode of the root directory is specified as 755. 



/etc/vchk_pw 

/etc/passwd 

/etc/vchk_tree 

/dev/tty 

< standard error > 

< standard output> 

< standard input > 



the file where vchk saves the password file summary. 

the password file. 

the default description file. 

where vchk prints questions and gets the responses 
(when the -i option is used). 

used to print all diagnostics. 

used to print shell commands and the newly built 
description file (when using the — b option). 

considered the default description file if it is a regular 
file. 



SEE ALSO 

chmod(l), ln(l), chown(lM). 

BUGS 

There is no way (except tediously via the — i option) to exclude directories 
from inspection when building a new description file. There is also no way, 
to automatically update an existing description file (i.e., to tell vchk to fix 
the description file instead of the filesystem). 
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NAME 

volcopy, labelit — copy file systems with label checking 

SYNOPSIS 

/etc/ volcopy [options] fsname special 1 volnamel special2 volname2 

/etc/Iabelit special I fsname volume [ — n ] ] 

DESCRIPTION 

Volcopy makes a literal copy of the file system using a blocksize matched to 
the device. Options are: 

-a invoke a verification sequence requiring a positive operator 

response instead of the standard 10 second delay before the 

copy is made, 

— s (default) invoke the DEL if wrong verification sequence. 

Other options are used only with tapes: 

-bpidensity bits-per-inch (i.e., 800/1600/6250), 
-feetsize size of reel in feet (i.e., 1200/2400), 

— reelnum beginning reel number for a restarted copy, 
-buf use double buffered I/O. 

The program requests length and density information if it is not given on 
the command line or is not recorded on an input tape label. If the file sys- 
tem is too large to fit on one reel, volcopy will prompt for additional reels. 
Labels of all reels are checked. Tapes may be mounted alternately on two 
or more drives. 

The fsname argument represents the mounted name (e.g.: root, ul, etc.) of 
the filsystem being copied. 

The special should be the physical disk section or tape (e.g.: /dev/rdskl5, 
/dev/rmtO, etc.). 

The volname is the physical volume name (e.g.: pk3, t0122, etc.) and 
should match the external label sticker. Such label names are limited to six 
or fewer characters. Volname may be — to use the existing volume name. 

Speciall and volnamel are the device and volume from which the copy of 
the file system is being extracted. Special2 and volname2 are the target dev- 
ice and volume. 

Fsname and volname are recorded in the last 12 characters of the superblock 
(char fsname(6], volname [6];). 

Labelit can be used to provide initial labels for unmounted disk or tape file 
systems. With the optional arguments omitted, labelit prints current label 
values. The - n option provides for initial labeling of new tapes only (this 
destroys previous contents). 

EXAMPLE 

volcopy newsys /dev/rrpl5 1 /dev/rfdO 1 

copies volume 1 of the file system labeled newsys mounted on /dev/rrpl5 
onto volume 1 of /dev/rfdO. 

labelit /dev/rfdO oldsys save 

relabels the file system mounted on /dev/rfdO with a new fsname of oldsys 
and a new volname of save. 

FILES 

/etc/log/filesave.log a record of file systems/volumes copied 
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SEE ALSO 

fs(4). 

BUGS 

Only device names beginning /dev/rmt are treated as tapes. Tape record 
sizes are determined both by density and by drive type. Records are 5,120 
bytes long at 800 and 1600 bits-per-inch, and 25,600 bytes long at 6250 
bits-per-inch. 
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NAME 

wall — write to all users 

SYNOPSIS 

/etc/wall 

DESCRIPTION 

Wall reads its standard input until an end-of-file. It then sends this mes- 
sage to all currently logged in users preceded by: 

Broadcast Message from . . . 

It is used to warn all users, typically prior to shutting down the system. 

The sender must be super-user to override any protections the users may 
have invoked (see mesgil)). 

EXAMPLE 

wall 

will broadcast the standard input to all users who are not protected against 
receiving messages by the mesg command. 

FILES 

/dev/tty* 

SEE ALSO 

mesg(l), write(l). 

DIAGNOSTICS 

"Cannot send to ..." when the open on a user's tty file fails. 
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NAME 

whodo — who is doing what 

SYNOPSIS 

/etc/whodo 

DESCRIPTION 

Whodo produces merged, reformatted, and dated output from the who(l) 
and psil) commands. 

EXAMPLE 

/etc/whodo 



will return something like the following: 



UNIX 




CO 


root 


13:52 


CO 


60 


0:01 sh 


CO 


61 


0:01 ps 


CO 


62 


0:00 sh 


SEE ALSO 






ps(l), who(l). 
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NAME 

intro — introduction to special files 

DESCRIPTION 

This section describes special files that refer to specific hardware peripherals 
and UNIX System device drivers. The names of the entries are generally 
derived from names for the hardware, as opposed to the names of the spe- 
cial files themselves. Characteristics of both the hardware device and the 
corresponding UNIX System device driver are discussed where applicable. 

BUGS 

While the names of the entries generally refer to vendor hardware names, 
in certain cases these names are seemingly arbitrary for various historical 
reasons. 
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NAME 

aliases — aliases file for delivermail 

SYNOPSIS 

/usr/lib/aliases 

DESCRIPTION 

This file describes user ID aliases that will be used by /etc/delivermaiL It 
is formatted as a series of lines of the form 
name:addrl,addr2,...addrn 

The name is the name to alias, and the addri are the addresses to send the 
message to. Lines beginning with white space are continuation lines. Lines 
beginning with ' # ' are comments. 

Aliasing occurs only on local names. Loops cannot occur since no message 
will be sent to any person more than once. 

SEE ALSO 

delivermail(8N). 
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NAME 

err — error-logging interface 

DESCRIPTION 

Minor device of the err driver is the interface between a process and the 
system's error-record collection routines. The driver may be opened only 
for reading by a single process with super-user permissions. Each read 
causes an entire error record to be retrieved; the record is truncated if the 
read request is for less than the record's length. 

FILES 

/dev/error special file 

SEE ALSO 

errdemon(lM). 
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NAME 

/etc/ hosts ~ host table for bnet 

DESCRIPTION 

The BNET host table is organized as follows: 

<inet-addr> <delim> < host-name > [<delim> <host-nicname> ] 
where 

<inet-addr> 

is a 32 bit type-a internet address, composed of one byte of "network 
number" followed by 3 bytes of local network address. Each byte is 
delimited by a period. For example, 
0x27.0.1.1 

refers to local-address 0x11 on network 0x27. Fields can be specified 
in decimal or hexadecimal notation. Normally, an installation will 
choose one network number for all hosts on the bnet (ethernet). 
Official type-a network numbers are assigned by the US DOD. Any 
network number less than 127 may be actually chosen if a particular 
installation is not planning to connect to the DCN network in the near 
future. Future releases of BNET will support type-b (16-bit) and 
type-c (24-bit) network numbers. See DCN/NIC RFC-790 for discus- 
sion of network numbers. Local-addresses are the low-order three 
bytes of the ethernet board address. The current release assumes a 
3com ethernet controller is installed, so the upper three bytes of the 
ethernet address is determined. This restriction will be removed in 
the next release of BNET. 

< delim > 

is a SINGLE SPACE. (!). 

< host-name > 

is the official name of the host. For the local host, this field should be 
exactly the same as the contents of /usr/lib/uucp/SYSTEMNAME, 
though no checks are made anywhere for this equivelance at this time. 
Since uucp limits the length of hostnames to seven characters, so does 
BNET, but this restriction will dissapear in the next release of BNET. 

< host-nicname > 

is a nicname or alias for the officially named host. Hosts can have 
several nicnames. 

LOCAL HOST 

The local host, i.e., the loopback driver, has a distinguished entry in the 
host table: 

127.0.0.1 myself 

That is, network number 127, host number 1. 
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EXAMPLE 

The following is a short host table for a network with two hosts. 

39.0.1.14 jeffj 
127.0.0.1 bill b 

The local host is named "bill" or "b". The remote host is named "jeff' or "j", 
If the remote host has a 3com ethernet controller, then it would have eth- 
ernet number Ox02608C00010D. The 0xO2608C is Scorn's manufacturer's 
ethernet number. 
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NAME 

mem, kmem — core memory 

DESCRIPTION 

Mem is a special file that is an image of the core memory of the computer. 
It may be used, for example, to examine, and even to patch the system. 

Byte addresses in mem are interpreted as memory addresses. References to 
non-existent locations cause errors to be returned. 

Examining and patching device registers is likely to lead to unexpected 
results when read-only or write-only bits are present. 

The file kmem is the same as mem except that kernel virtual memory rather 
than physical memory is accessed. 

FILES 

/dev/mem 
/dev/kmem 
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NAME 

null — the null file 

DESCRIPTION 

Data written on a null special file is discarded. 

Reads from a null special file always return bytes. 

FILES 

/dev/null 
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NAME 

termio — general terminal interface 

DESCRIPTION 

This section describes both a particular special file and the general nature of 
the terminal interface. 

The file /dev/tty is, in each process, a synonym for the control terminal 
associated with the process group of that process, if any. It is useful for 
programs or shell sequences that wish to be sure of writing messages on the 
terminal no matter how output has been redirected. It can also be used for 
programs that demand the name of a file for output, when typed output is 
desired and it is tiresome to find out what terminal is currently in use. 

All of the asynchronous communications ports use the same general inter- 
face, no matter what hardware is involved. The remainder of this section 
discusses the common features of this interface. 

When a terminal file is opened, it normally causes the process to wait until 
a connection is established. In practice, users' programs seldom open these 
files; they are opened by getty and become a user's standard input, output, 
and error files. The very first terminal file opened by the process group 
leader of a terminal file not already associated with a process group 
becomes the control terminal for that process group. The control terminal 
plays a special role in handling quit and interrupt signals, as discussed 
below. The control terminal is inherited by a child process during a 
fork (2). A process can break this association by changing its process group 
using setpgrpiD. 

A terminal associated with one of these files ordinarily operates in full- 
duplex mode. Characters may be typed at any time, even while output is 
occurring, and are only lost when the system's character input buffers 
become completely full, which is rare, or when the user has accumulated 
the maximum allowed number of input characters that have not yet been 
read by some program. Currently, this limit is 256 characters. When the 
input limit is reached, all the saved characters are thrown away without 
notice. 

Normally, terminal input is processed in units of lines. A line is delimited 
by a new-line (ASCII LF) character, an end-of-file (ASCII EOT) character, or 
an end-of-line character. This means that a program attempting to read will 
be suspended until an entire line has been typed. Also, no matter how 
many characters are requested in the read call, at most one line will be 
returned. It is not, however, necessary to read a whole line at once; any 
number of characters may be requested in a read, even one, without losing 
information. 

During input, erase and kill processing is normally done. By default, the 
character # erases the last character typed, except that it will not erase 
beyond the beginning of the line. By default, the character @ kills 
(deletes) the entire input line, and optionally outputs a new-line character. 
Both these characters operate on a key-stroke basis, independently of any 
backspacing or tabbing that may have been done. Both the erase and kill 
characters may be entered literally by preceding them with the escape char- 
acter (\) . In this case the escape character is not read. The erase and kill 
characters may be changed. 
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Certain characters have special functions on input. These functions and 
their default character values are summarized as follows: 

INTR (Rubout or ASCII DEL) generates an interrupt signal which is sent 
to all processes with the associated control terminal. Normally, 
each such process is forced to terminate, but arrangements may 
be made either to ignore the signal or to receive a trap to an 
agreed-upon location; see signaKl). 

QUIT (Control-! or ASCII FS) generates a quit signal. Its treatment is 
identical to the interrupt signal except that, unless a receiving 
process has made other arrangements, it will not only be ter- 
minated but a core image file (called core) will be created in the 
current working directory. 

ERASE (#) erases the preceding character. It will not erase beyond the 
start of a line, as delimited by a NL, EOF, or EOL character. 

KILL (@) deletes the entire line, as delimited by a NL, EOF, or EOL 
character. 

EOF (Control-d or ASCII EOT) may be used to generate an end-of-file 

from a terminal. When received, all the characters waiting to be 
read are immediately passed to the program, without waiting for a 
new-line, and the EOF is discarded. Thus, if there are no charac- 
ters waiting, which is to say the EOF occurred at the beginning of 
a line, zero characters will be passed back, which is the standard 
end-of-file indication. 

NL (ASCII LF) is the normal line delimiter. It can not be changed or 

escaped. 

EOL (ASCII NUL) is an additional line delimiter, like NL. It is not nor- 

mally used. 

STOP (Control-s or ASCII DC3) can be used to temporarily suspend out- 
put. It is useful with CRT terminals to prevent output from 
disappearing before it can be read. While output is suspended, 
STOP characters are ignored and not read. 

START (Control-q or ASCII DCl) is used to resume output which has 
been suspended by a STOP character. While output is not 
suspended, START characters are ignored and not read. The 
start/ stop characters can not be changed or escaped. 

The character values for INTR, QUIT, ERASE, KILL, EOF, and EOL may be 
changed to suit individual tastes. The ERASE, KILL, and EOF characters 
may be escaped by a preceding \ character, in which case no special func- 
tion is done. 

When the carrier signal from the data-set drops, a hangup signal is sent to 
all processes that have this terminal as the control terminal. Unless other 
arrangements have been made, this signal causes the processes to ter- 
minate. If the hangup signal is ignored, any subsequent read returns with 
an end-of-file indication. Thus programs that read a terminal and test for 
end-of-file can terminate appropriately when hung up on. 

When one or more characters are written, they are transmitted to the ter- 
minal as soon as previously-written characters have finished typing. Input 
characters are echoed by putting them in the output queue as they arrive. 
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If a process produces characters more rapidly than they can be typed, it 
will be suspended when its output queue exceeds some limit. When the 
queue has drained down to some threshold, the program is resumed. 

Several ioctl{2) system calls apply to terminal files. The primary calls use 
the following structure, defined in <termio.h>: 



/* input modes */ 
/• output modes */ 
/* control modes */ 
/* local modes */ 
/* line discipline */ 
/* control chars */ 



#define 


NCC 


8 




struct 


termio { 








unsigned 


short 


c_iflag; 




unsigned 


short 


coflag; 




unsigned 


short 


c_cflag; 




unsigned 


short 


clflag; 




char 




c line; 




unsigned 


char 


c_cc[NCC]; 



The special control characters are defined by the array c_cc. The relative 
positions and initial values for each function are as follows: 



INTR 


DEL 


1 QUIT 


FS 


2 ERASE 


# 


3 KILL 


@ 


4 EOF 


EOT 


5 EOL 


NUL 


6 reserved 


7 reserved 


c_iflag field describes 1 


IGNBRK 


0000001 


BRKINT 


0000002 


IGNPAR 


0000004 


PARMRK 


0000010 


INPCK 


0000020 


ISTRIP 


0000040 


INLCR 


0000100 


IGNCR 


0000200 


ICRNL 


0000400 


lUCLC 


0001000 


IXON 


0002000 


IXANY 


0004000 


IXOFF 


0010000 



Ignore break condition. 

Signal interrupt on break. 

Ignore characters with parity errors. 

Mark parity errors. 

Enable input parity check. 

Strip character. 

Map NL to CR on input. 

Ignore CR. 

Map CR to NL on input. 

Map upper-case to lower-case on input. 

Enable start/ stop output control. 

Enable any character to restart output. 

Enable start/ stop input control. 

If IGNBRK is set, the break condition (a character framing error with data 
all zeros) is ignored, that is, not put on the input queue and therefore not 
read by any process. Otherwise if BRKINT is set, the break condition will 
generate an interrupt signal and flush both the input and output queues. If 
IGNPAR is set, characters with other framing and parity errors are ignored. 

If PARMRK is set, a character with a framing or parity error which is not 
ignored is read as the three character sequence: 0377, 0, X, where X is the 
data of the character received in error. To avoid ambiguity in this case, if 
ISTRIP is not set, a valid character of 0377 is read as 0377, 0377. If 
PARMRK is not set, a framing or parity error which is not ignored is read as 
the character NUL (0). 
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If INPCK is set, input parity checking is enabled. If INPCK is not set, input 
parity checking is disabled. This allows output parity generation without 
input parity errors. 

If ISTRIP is set, valid input characters are first stripped to 7-bits, otherwise 
all 8-bits are processed. 

If INLCR is set, a received NL character is translated into a CR character. If 
IGNCR is set, a received CR character is ignored (not read). Otherwise if 
ICRNL is set, a received CR character is translated into a NL character. 

If lUCLC is set, a received upper-case alphabetic character is translated into 
the corresponding lower-case character. 

If IXON is set, start/ stop output control is enabled. A received STOP char- 
acter will suspend output and a received START character will restart out- 
put. All start/stop characters are ignored and not read. If IXANY is set, 
any input character, will restart output which has been suspended. 

If IXOFF is set, the system will transmit START/STOP characters when the 
input queue is nearly empty/full. 

The initial input control value is all bits clear. 

The c_oflag field specifies the system treatment of output: 

Postprocess output. 

Map lower case to upper on output. 

Map NL to CR-NL on output. 

Map CR to NL.on output. 

No CR output at column 0. 

NL performs CR function. 

Use fill characters for delay. 

Fill is DEL, else NUL. 

Select new-line delays: 



Select carriage-return delays: 



OPOST 


0000001 


OLCUC 


0000002 


ONLCR 


0000004 


OCRNL 


0000010 


ONOCR 


0000020 


ONLRET 


0000040 


OFILL 


0000100 


OFDEL 


0000200 


NLDLY 


0000400 


NLO 





NLl 


0000400 


CRDLY 


0003000 


CRO 





CRl 


0001000 


CR2 


0002000 


CR3 


0003000 


TABDLY 


0014000 


TABO 





TAB! 


0004000 


TAB2 


0010000 


TAB3 


0014000 


BSDLY 


0020000 


BSO 





BSl 


0020000 


VTDLY 


0040000 


VTO 





VTl 


0040000 


FFDLY 


0100000 


FFO 





FFl 


0100000 



Select horizontal-tab delays: 



Expand tabs to spaces. 
Select backspace delays: 



Select vertical-tab delays: 



Select form-feed delays: 



If OPOST is set, output characters are post-processed as indicated by the 
remaining flags, otherwise characters are transmitted without change. 
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If OLCUC is set, a lower-case alphabetic character is transmitted as the 
corresponding upper-case character. This function is often used in conjunc- 
tion with lUCLC. 

If ONLCR is set, the NL character is transmitted as the CR-NL character 
pair. If OCRNL is set, the CR character is transmitted as the NL character. 
If ONOCR is set, no CR character is transmitted when at column (first 
position). If ONLRET is set, the NL character is assumed to do the 
carriage-return function; the column pointer will be set to and the delays 
specified for CR will be used. Otherwise the NL character is assumed to do 
just the line-feed function; the column pointer will remain unchanged. The 
column pointer is also set to if the CR character is actually transmitted. 

The delay bits specify how long transmission stops to allow for mechanical 
or other movement when certain characters are sent to the terminal. In all 
cases a value of indicates no delay. If OFILL is set, fill characters will be 
transmitted for delay instead of a timed delay. This is useful for high baud 
rate terminals which need only a minimal delay. If OFDEL is set, the fill 
character is DEL, otherwise NUL. 

If a form-feed or vertical-tab delay is specified, it lasts for about 2 seconds. 

New-line delay lasts about 0.10 seconds. If ONLRET is set, the carriage- 
return delays are used instead of the new-line delays. If OFILL is set, two 
fill characters will be transmitted. 

Carriage-return delay type 1 is dependent on the current column position, 
type 2 is about 0.10 seconds, and type 3 is about 0.15 seconds. If OFILL is 
set, delay type 1 transmits two fill characters, and type 2 four fill characters. 

Horizontal-tab delay type 1 is dependent on the current column position. 
Type 2 is about 0.10 seconds. Type 3 specifies that tabs are to be expanded 
into spaces. If OFILL is set, two fill characters will be transmitted for any 
delay. 

Backspace delay lasts about 0.05 seconds. If OFILL is set, one fill character 
will be transmitted. 

The actual delays depend on line speed and system load. 

The initial output control value is all bits clear. 

The ccflag field describes the hardware control of the terminal: 

CBAUD 0000017 Baud rate: 

BO Hang up 

B50 0000001 50 baud 

B75 0000002 75 baud 

BllO 0000003 110 baud 

B134 0000004 134.5 baud 

B150 0000005 150 baud 

B200 0000006 200 baud 

B300 0000007 300 baud 

B600 0000010 600 baud 

B1200 0000011 1200 baud 

B1800 0000012 1800 baud 

B2400 0000013 2400 baud 

B4g00 0000014 4800 baud 

B9600 0000015 9600 baud 

EXTA 0000016 External A 
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EXTB 


0000017 


External B 




CSIZE 


0000060 


Character size: 




CSS 





5 bits 




CS6 


0000020 


6 bits 




CS7 


0000040 


7 bits 




CSS 


0000060 


8 bits 




CSTOPB 


0000100 


Send two stop bits, else one. 




CREAD 


0000200 


Enable receiver. 




PARENS 


0000400 


Parity enable. 




PARODD 


0001000 


Odd parity, else even. 




HUPCL 


0002000 


Hang up on last close. 




CLOCAL 


0004000 


Local line, else dial-up. 





The CBAUD bits specify the baud rate. The zero baud rate, BO, is used to 
hang up the connection. If BO is specified, the data-terminal-ready signal 
will not be asserted. Normally, this will disconnect the line. For any par- 
ticular hardware, impossible speed changes are ignored. 

The CSIZE bits specify the character size in bits for both transmission and 
reception. This size does not include the parity bit, if any. If CSTOPB is 
set, two stop bits are used, otherwise one stop bit. For example, at 110 
baud, two stops bits are required. 

If PARENB is set, parity generation and detection is enabled and a parity bit 
is added to each character. If parity is enabled, the PARODD flag specifies 
odd parity if set, otherwise even parity is used. 

If CREAD is set, the receiver is enabled. Otherwise no characters will be 
received. 

If HUPCL is set, the line will be disconnected when the last process with the 
line open closes it or terminates. That is, the data-terminal-ready signal 
will not be asserted. 

If CLOCAL is set, the line is assumed to be a local, direct connection with 
no modem control. Otherwise modem control is assumed. 

The initial hardware control value after open is B300, CSS, CREAD, 
HUPCL. 

The cjflag field of the argument structure is used by the line discipline to 
control terminal functions. The basic line discipline (0) provides the fol- 
lowing: 

Enable signals. 

Canonical input (erase and kill processing). 

Canonical upper/lower presentation. 

Enable echo. 

Echo erase character as BS-SP-BS. 

Echo NL after kill character. 

Echo NL. 

Disable flush after interrupt or quit. 

If ISIG is set, each input character is checked against the special control 
characters INTR and QUIT. If an input character matches one of these con- 
trol characters, the function associated with that character is performed. If 
ISIG is not set, no checking is done. Thus these special input functions are 
possible only if ISIG is set. These functions may be disabled individually by 
changing the value of the control character to an unlikely or impossible 



ISIG 


0000001 


ICANON 


0000002 


XCASE 


0000004 


ECHO 


0000010 


ECHOE 


0000020 


ECHOK 


0000040 


ECHONL 


0000100 


NOFLSH 


0000200 
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value (e.g. 0377). 

If ICANON is set, canonical processing is enabled. This enables the erase 
and kill edit functions, and the assembly of input characters into lines del- 
imited by NL, EOF, and EOL. If ICANON is not set, read requests are 
satisfied directly from the input queue. A read will not be satisfied until at 
least MIN characters have been received or the timeout value TIME has 
expired. This allows fast bursts of input to be read efficiently while still 
allowing single character input. The MIN §nd TIME values are stored in the 
position for the EOF and EOL characters respectively. The time value 
represents tenths of seconds. 

If XCASE is set, and if ICANON is set, an upper-case letter is accepted on 
input by preceding it with a \ character, and is output preceded by a \ char- 
acter. In this mode, the following escape sequences are generated on out- 
put and accepted on input: 



for. 


use: 


'% 


V 


l_ 


\l 




V 


{ 


\( 


} 


\) 


\ 


w 



For example, A is input as \a, \n as \\n, and \N as \\\n. 

If ECHO is set, characters are echoed as received. 

When ICANON is set, the following echo functions are possible. If ECHO 
and ECHOE are set, the erase character is echoed as ASCII BS SP BS, which 
will clear the last character from a CRT screen. If ECHOE is set and ECHO 
is not set, the erase character is echoed as ASCII SP BS. If ECHOK is set, 
the NL character will be echoed after the kill character to emphasize that 
the line will be deleted. Note that an escape character preceding the erase 
or kill character removes any special function. If ECHONL is set, the NL 
character will be echoed even if ECHO is not set. This is useful for termi- 
nals set to local echo (so-called half duplex). Unless escaped, the EOF 
character is not echoed. Because EOT is the default EOF character, this 
prevents terminals that respond to EOT from hanging up. 

If NOFLSH is set, the normal flush of the input and output queues associ- 
ated with the quit and interrupt characters will not be done. 

The initial line-discipline control value is all bits clear. 

The primary ioctlO) system calls have the form: 

ioctl (fildes, command, arg) 
struct termio *arg; 

The commands using this form are: 

TCGETA Get the parameters associated with the terminal and 
store in the termio structure referenced by arg. 

TCSETA Set the parameters associated with the terminal from the 
structure referenced by arg. The change is immediate. 

TCSETAW Wait for the output to drain before setting the new 
parameters. This form should be used when changing 
parameters that will affect output. 
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TCSETAF Wait for the output to drain, then flush the input queue 
and set the new parameters. 

Additional ioctlil) calls have the form: 

ioctl (fildes, command, arg) 
int arg; 

The commands using this form are: 

TCSBRK Wait for the output to drain. If arg is 0, then send a 
break (zero bits for 0.25 seconds). 

TCXONC Start/stop control. If arg is 0, suspend output; if 1, res- 
tart suspended output. 

TCFLSH If arg is 0, flush the input queue; if 1, flush the output 
queue; if 2, flush both the input and output queues. 

FIONREAD Return the number of characters currently in a 
terminal's input buff'er into the integer pointer rg. ICAN- 
NON mode must be set for this option to work. 



FILES 



/dev/tty 

/dev/tty* 

/dev/console 

SEE ALSO 

stty(l), ioctl (2). 
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NAME 

tty — controlling terminal interface 

DESCRIPTION 

The file /dev/tty is, in each process, a synonym for the control terminal 
associated with the process group of that process, if any. It is useful for 
programs or shell sequences that wish to be sure of writing messages on the 
terminal no matter how output has been redirected. It can also be used for 
programs that demand the name of a file for output, when typed output is 
desired and it is tiresome to find out what terminal is currently in use. 

FILES 

/dev/tty 
/dev/tty* 
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NAME 

intro — introduction to system maintenance procedures 

DESCRIPTION 

This section outlines procedures that will be of interest to those charged 
with the task of system maintenance. Included are discussions on the 
topics of boot procedures and recovery from crashes. 

BUGS 

No manual can take the place of good, solid experience. 
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NAME 

boot — startup procedures 

DESCRIPTION 

A 68000 UNIX system is typically started by a two-stage process. The first 
is a primary bootstrap which is used to read in the system itself. 

The primary bootstrap, when read into memory and executed, sets up 
memory management if necessary, and types a prompt message on the con- 
sole. Then it reads from the console a device specification (see below) fol- 
lowed immediately by a pathname. This program finds the corresponding 
file on the given device, loads that file into the proper memory location, 
and then transfers control of the program. Normal line editing characters 
can be used. 

Conventionally, the name of the current version of the system is Vunix'. 
Then, the recipe is: 

1) Load the boot program by fiddling with the console keys and crt as 
appropriate for your hardware. 

2) When the ":" prompt is given, type [for example] 
fpy (0,0) Unix 

or 

hd (0,0) Unix 

depending on whether you are loading from floppy or hard disk, respec- 
tively. The first indicates the physical unit number; the second indi- 
cates the block number of the beginning of the logical file system (dev- 
ice) to be searched. (See below). 

When asked for the device name, a list of valid device names can be 
obtained by typing a "?" followed by a carriage return. A carriage 
return by itself boots the UNIX system on the default device. 

When the system is running, it types a "#" prompt. After doing any file 
system checks \mfscki\) and setting the date idate(l)), the system can be 
brought up for standard operation by typing init 2 in response to the "#" 
prompt, then an EOT (control-d) when the system requests it. 

Device Specifications 

A device specification has the following form: 

device (unit,off set) 

where device is the type of the device to be searched, unit is the unit 
number of the device, and offset is the block oflFset of the file system on the 
device. Device specifications vary according to which 68000 UNIX system 
you are using. Check manufacturer's instructions for the device 
specifications. 

For example, the specification 

hp(l,7000) 

would indicate an HP disk, unit 1, and the file system found starting at 
block 7000. 

ROM Programs 

Programs to call the primary bootstrap may be installed in read-only 
memories or manually keyed into main memory. Each program is 
position-independent but should be placed well above location so it will 
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not be overwritten. See manufacturer's instructions for a manually keyed- 
in ROM boot program, should one become necessary. 

FILES 

/unix — system code 
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NAME 

crash — what to do when the system crashes 

DESCRIPTION 

This entry gives at least a few clues about how to proceed if the system 
crashes. It can't pretend to be complete. 

In restarting after a crash, always bring up the system single-user, as 
specified in 600/(8) as modified for your particular installation. Then per- 
form an fsckilM) on all file systems which could have been in use at the 
time of the crash. If any serious file system problems are found, they 
should be repaired. When you are satisfied with the health of your disks, 
check and set the date if necessary, then come up multi-user. 

To even boot UNIX at all, certain files (and the directories leading to them) 
must be intact. First, the initialization program /etc/init must be present 
and executable. For init to work correctly, /dev/console, /bin/sh and 
/bin/env must be present. If one of these does not exist, the symptom is 
best described as thrashing. Init will go into a fork/exec loop trying to create 
a Shell with proper standard input and output. The file /etc/rc should also 
be there and be executable; the system will come up but will not be fully 
initialized without it. 

If you cannot get the system to boot, a runnable system must be obtained 
from a backup medium. The root file system may then be doctored as a 
mounted file system as described below. If there are any problems with the 
root file system, it is probably prudent to go to a backup system to avoid 
working on a mounted file system. 

Repairing disks. The first rule to keep in mind is that an addled disk should 
be treated gently; it shouldn't be mounted unless necessary, and if it is very 
valuable yet in quite bad shape, perhaps it should be copied before trying 
surgery on it. This is an area where experience and informed courage 
count for much. 

FsckilM) is adept at diagnosing and repairing file system problems. It first 
identifies all of the files that contain bad (out of range) blocks or blocks 
that appear in more than one file. Any such files are then identified by 
name and fsck requests permission to remove them from the file system. 
Files with bad blocks should be removed. In the case of duplicate blocks, 
all of the files except the most recently modified should be removed. The 
contents of the survivor should be checked after the file system is repaired 
to ensure that it contains the proper data. (Note that running fsck with the 
— n option will cause it to report all problems without attempting any 
repair.) 

Fsck will also report on incorrect link counts and will request permission to 
adjust any that are erroneous. In addition, it will reconnect any files or 
directories that are allocated but have no file system references to a 
"lost+ found" directory. Finally, if the free list is bad (out of range, miss- 
ing, or duplicate blocks) fsck will, with the operators concurrence, construct 
a new one. 

IVhy did it crashl UNIX types a message on the console typewriter when it 
voluntarily crashes. Here is the current list of such messages, with enough 
information to provide a hope at least of the remedy. The message has the 
form "panic:...", possibly accompanied by other information. Left 
unstated in all cases is the possibility that hardware or software error 
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produced the message in some unexpected way. 

bikdev 

The getblk routine was called with a nonexistent major device as argu- 
ment. Definitely hardware or software error. 

devtab 

Null device table entry for the major device used as argument to getblk. 
Definitely hardware or software error. 

dpfrelse 

The list of processes currently mapped into the memory management 
unit has been lost (68451 only). 

iinit 

An I/O error reading the super-block for the root file system during ini- 
tialization. 

interrupt stack overflow 

The kernel ran out of stack space on an interrupt. Subroutine depth is 
too great or too many local variables. 

kernel memory management error 

Bus error or address error in supervisor mode. Can be a software or 
hardware problem. 

no fs 

A device has disappeared from the mounted-device table. Definitely 
hardware or software error. 

no imt 

Like "no fs", but produced elsewhere. 

no clock 

During initialization, neither the line nor programmable clock was found 
to exist. 

no procs 

Process table has been destroyed. 

I/O error in swap 

An unrecoverable I/O error during a swap. Really shouldn't be a panic, 
but it is hard to fix. 

oops!!! syscall 

The interrupt vector for system calls is missing. 

out of swap space 

A program needs to be swapped out, and there is no more swap space. 
It has to be increased. This really shouldn't be a panic, but there is no 
easy fix. 

timeout table overflow 

The timeout table overflowed. The timeout table is not large enough or 
some routine is starting up too many timeouts. 

trap 

An unexpected trap has occurred within the system. This is accom- 
panied by the following information: 

trap type 

2 bus error 

3 address error 
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4 illegal instruction 

5 divide by zero 

6 CHK instruction 

7 TRAPV instruction 

8 privilege violation 

9 trace 

10 1010 emulator 

11 1111 emulator 
12-255 unexpected interrupt 

virtual address (for bus/address errors only) 
physical address 
instruction register 
function code 

mmu dump 

program counter 
status register 
program id 

registers 

In some of these cases it is possible for hex 1000 to be added into the trap 
type; this indicates that the processor was in user mode when the trap 
occurred. 

SEE ALSO 

adb(l), fsck(lM), boot(8). 
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NAME 

delivermail — deliver mail to arbitrary people 

SYNOPSIS 

/etc/delivermail [ -[fr] address ] [ — a 1 [ -e[empqw] ] [ — n ] [ 
-m] [ -s] [ -i] [ -h A^] address ... 

DESCRIPTION 

Delivermail delivers a letter to one or more people, routing the letter over 
whatever networks are necessary. Delivermail will do inter-net forwarding 
as necessary to deliver the mail to the correct place. 

Delivermail is not intended as a user interface routine; it is expected that 
other programs will provide user-friendly front ends, and delivermail will be 
used only to deliver pre-formatted messages. 

Delivermail reads its standard input up to a control-D or a single dot and 
sends a copy of the letter found there to all of the addresses listed. If the 
-i flag is given, single dots are ignored. It determines the network to use 
based on the syntax of the addresses. Addresses containing the character 
"@" or the word "at" are sent to BNET; and addresses containing "!" are sent 
to the UUCP net. Other addresses are assumed to be local. 

Local addresses are looked up in the file /usr/lib/aliases and aliased 
appropriately. Aliasing can be prevented by preceding the address with a 
backslash or using the — n flag. Normally the sender is not included in any 
alias expansions, e.g., if "John" sends to "group", and "group" includes 
"John" in the expansion, then the letter will not be delivered to "John". The 
— m flag disables this suppression. 

Delivermail computes the person sending the mail by looking at your login 
name. The "from" person can be explicitly specified by using the — f flag; 
or, if the - a flag is given, delivermail looks in the body of the message for 
a "From:" or "Sender:" field in ARPANET format. The -f and -a flags can 
be used only by the special users root and network, or if the person you are 
trying to become is the same as the person you are. The - r flag is entirely 
equivalent to the - f flag; it is provided for ease of interface only. 

The —ex flag controls the disposition of error output, as follows: 

e Print errors on the standard output, and echo a copy of the message 
when done. It is assumed that a network server will return the mes- 
sage back to the user. 

m Mail errors back to the user. 

p Print errors on the standard output. 

q Throw errors away; only exit status is returned. 

w Write errors back to the user's terminal, but only if the user is still 
logged in and write permission is enabled; otherwise errors are mailed 
back. 

If the error is not mailed back, and if the mail originated on the machine 
where the error occurred, the letter is appended to the file "dead.letter" in 
the sender's home directory. 

If the first character of the user name is a vertical bar, the rest of the user 
name is used as the name of a program to pipe the mail to. It may be 
necessary to quote the name of the user to keep delivermail from supressing 
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the blanks from between arguments. 

The message is normally edited to eliminate "From" lines that might con- 
fuse other mailers. In particular, "From" lines in the header are deleted, 
and "From" lines in the body are prepended by ">". The — s flag saves 
"From" lines in the header. 

The — h flag gives a "hop-count", i.e., a measure of how many times this 
message has been processed by delivermail (presumably on difl^erent 
machines). Each time delivermail processes a message, it increases the 
hop-count by one; if it exceeds 30 delivermail assumes that an alias loop has 
occurred and it aborts the message. The hop-count defaults to zero. 

Delivermail returns an exit status describing what it did. The codes are 
defined in mailexits.h: 

EXOK Succesful completion on all addresses. 

2 EXNOUSER User name not recognized. 

3 EXUNAVAILABLE Catchall meaning necessary resources were not 

available. 

4 EX_SYNTAX Syntax error in address. 

5 EXSOFTWARE Internal software error, including bad arguments. 

6 EXOSERR Temporary operating system error, such as "cannot 

fork". 



7 EX_NOHOST Host name not recognized. 



FILES 



/usr/ lib/ aliases to alias names 

/bin/ mail to deliver local mail 

/etc/netmailer to deliver BNET mail 

/bin/mail to deliver UUCP mail (/bin/mail knows how...) 

/tmp/mail* temp file 

/tmp/xscript* saved transcript 

/dev/log to log status (optional) 

SEE ALSO 

mail(l), aliases(7N), netmailer(8N). 

BUGS 

Delivermail sends one copy of the letter to each user, it should send one 
copy of the letter to each host and distribute to multiple users there when- 
ever possible. 

Delivermail assumes the addresses can be represented as one word. This is 
incorrect according to the ARPANET mail protocol RFC 733 ( NIC 41952), 
but is consistent with the real world. 
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NAME 

netmail — the bnet network mail system 

DESCRIPTION 

The bnet network mail system consists of the following programs: 

/etc/bnetmaild 

a simple mail daemon run by crontab or by hand. Looks in the mail 
spool directory (/usr/spool/netmail) for files to send out onto the net- 
work. Uses remsh to send mail to remote hosts. Deletes mail if the 
mail is apparently successfully sent. Deletes mail found lying around 
which is more than one week old; apparently the destination host in 
this case is off the net. Accepts no arguments. 

/etc/delivermail 

exec'd by /bin/mail to deliver mail to users or networks depending 
on the contents of the address of the mail. If the address contains an 

@ then deliver to the bnet network, else if the address has a 

! then deliver to the uucp network, 

else deliver locally. 

/etc/netmailer 

exec'd by /etc/delivermail to "deliver" netmail. Mail is actually depo- 
sited in /usr/spool/netmail with appropriate network mail headers 
prepended. /etc/bnetmaild actually sends the mail to the network. 
See netmailer{%^) for a description of flag arguments. 

/bin/mail 

has been modified to exec /etc/delivermail (delivermaiiiS'N)) which 
does aliasing and re-routing of mail destined for the b-network. 

FILES 

/usr/spool/netmail 

directory for network mail 

/ usr/ spool/netmail/ bnetXXXXXX 

actual mail file(s), XXXXXX = pid. 

SEE ALSO 

mail(l), remsh(lN), deliver mail(8N), netmailer(8N). 



BUGS 



Many, no doubt; for example, lots of work should be done on 
/etc/bnetmaild, i.e., if a piece of mail is deleted due to its being old or oth- 
erwise undeliverable, notification should be sent to the originator. Soon, 
however, bnetmaild y/i\\ be replaced by sendmail. 

A front-end is needed for mail, such as Mai! (ucb) . 
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NAME 

netmailer — deliver mail to BNET 

SYNOPSIS 

/etc/netmailer from-address to-host to-user 

DESCRIPTION 

Netmailer queues the letter found on its standard input for delivery to the 
host and user specified. The actual delivery will be performed by the BNET 
mailer daemon (/etc/bnetmaild). 

If the letter does not appear to have a full BNET header, netmailer will 
insert "Date:" and "From:" fields in the proper format. The "From:" person 
is determined by the from-address argument, with colons translated to 
periods and "@< local- host >" appended. The "< local-host >" is obtained 
from the file /usr/lib/uucp/SYSTEMNAME. 



FILES 



/ usr/ spool/ ne tmail/ * 



SEE ALSO 

delivermail(8N), netmail(8N). 
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